深度 揭秘 流行 AppP 背 后 的 手机 开发 技术 ， 展 示 移 动 信息 科技 的 最 新 工程 实践 
一 企业 级 开发 从 产品 经 理 和 设计 师 的 角度 深入 浅 出 地 介绍 Android 
App 从 开发 、 调 试 到 上 线 的 企业 级 开发 流程 
一 突出 实战 ， 项 目 丰富 提供 19 个 流行 App 开 发 范例 ， 每 个 范例 均 给 
出 设计 思路 与 注释 详尽 的 代码 
一 技术 先进 ， 涉 及 面 广 包括 物 联 网 、 虚 拟 现实 、 人 工 智 能 新 技术 应 
用 及 最 新 的 科研 成 果 (如 北斗 导航 、SM3 国 密 等 ) 
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内 容 简 介 


本 书 是 一 部 Android 开发 的 实战 教程 ， 由 浅 入 深 、 由 基础 到 高 级 ,带领 读者 一 步 一 步 走 进 App 开发 的 神奇 世界 。 

全 书 共 分 为 16 章 。 其 中 ， 前 8 章 是 基础 部 分 ， 主 要 讲解 Android Studio 的 环境 搭建 、App 开发 的 各 种 
常用 控件 、App 的 数据 存储 方式 、 如 何 调试 App 并 将 App 发 布 上 线 ; 后 8 章 是 进 阶 部 分 ， 主 要 讲解 App 开发 的 
设备 操作 、 网 络 通信 、 事 件 、 动 画 、 多 媒体 、 融 合 技术 、 第 三 方 开发 包 、 性 能 优化 等 。 书 中 在 讲解 知识 点 的 
同时 给 出 了 大 量 实战 范例 , 方便 读者 迅速 将 所 学 的 知识 运用 到 实际 开发 中 。 通 过 本 书 的 学 习 , 读者 能 够 掌握 3 
类 主流 App 的 基本 开发 技术 ， 包 括 购物 App《〈 电 子 商务 ) 、 聊 天 App〈 即 时 通信 ) 、 打 车 App〈 交 通 出 行 ) 。 
另外 ， 能 够 学 会 开发 一 些 趣味 应 用 ， 包 括 简单 计算 器 、 房 贷 计 算 器 、 万 年 历 、 日 程 表 、 手 机 安全 助手 、 指 南 
针 、 卫 星 浑 天 仪 、 应 用 超市 、 抠 图 工具 、 全 景 图 库 、 动 感 影集 、 影 视 播放 器 、 音 乐 播放 器 、WiFi 共享 器 、 电 


子 书架 等 。 


本 书 适 用 于 Android 开发 的 广大 从 业者 、 有 志 于 转型 App 开发 的 程序 员 、App 开发 的 业余 爱好 者 ， 也 可 


作为 大 中 专 院 校 与 培训 机 构 的 Android 课程 教材 。 
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推荐 序 


计算 机 的 发 展 是 以 信息 智能 化 与 小 型 化 为 进化 路 线 ， 从 IBM 庞大 的 巨型 机 到 比 
尔 盖 茨 的 个 人 电脑 ,信息 无 所 不 在 。 乔 布 斯 的 伟大 之 处 在 于 “用 一 个 手指 头 改 变 世 界 ”。 
当 全 世界 的 粉丝 用 苹果 手机 的 时 候 ， 移 动 开 发 领域 开始 全 面 地 封闭 在 iOS 的 体系 里 。 
安 卓 作 为 移动 手机 和 设备 开放 象征 的 另 一 级 ， 更 具有 活力 和 前 途 。 

欧阳 先生 是 一 位 具有 丰富 程序 开发 经 验 的 架构 师 和 项 目 管理 者 ,平时 常常 思考 和 
总 结 21 世纪 以 来 我 国 软件 开发 者 ， 特 别 是 移动 开发 工程 师 的 困惑 。 社 会 从 “一 支 笔 
的 科学 家 时 代 ” 发 展 到 “一 个 键盘 开发 App 改变 世界 ”， 对 程序 员 来 说 ， 用 自己 的 
智慧 进行 移动 应 用 开发 是 创业 的 捷径 。 读 者 遵循 书 中 的 指引 ， 很 快 能 够 登 堂 入 室 , 成 
为 当前 安 卓 应 用 开发 的 精英 人 才 。 

本 书 对 所 有 有 志 于 进行 安 卓 系统 开发 的 人 员 而 言 具 有 非常 重要 的 意义 。 








杭州 海 适 云 承 科技 有 限 公司 
董事 长 兼 首席 架构 师 
沈 英 桓 
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时 光 荃 黄 犹 如 白 驹 过 隙 , 转瞬 之 间 本 书 离 初 版 已 近 两 年 , 在 此 期 间 信息 科技 的 快速 发 展 令 
人 目不暇接 。 物 联网 方兴未艾 ， 虚拟 现实 潮 起 潮 落 ， 共 享 经 济 遍 地 开花 ， 人 工 智能 火 得 一 塌 糊 
涂 ， 第 四 次 工业 革命 蓄 势 待 发， 而 移动 互联 网 从 狂 毅 回归 到 常态 。 

单 就 App 开发 而 言 , 安 卓 系统 版 本 从 2016 年 的 Android7 到 2017 年 的 Android 8 再 到 2018 
年 的 Android 9，Android Studio 的 版 本 也 从 2016 年 的 2.2 更 新 到 2.3、3.0、3.1 直到 2018 年 的 
3.2， 同 时 Android 的 开发 语言 除了 Java 以 外 又 多 了 一 个 Kotlin。 从 应 用 场景 来 说 ， 早 期 只 运 
行 于 手机 和 平板 电脑 的 安 卓 系统 ,现在 逐步 拓展 到 了 互联 网 电视 、 可 穿戴 设备 、 车 载 终端 、 智 
能 家 居 等 其 他 设备 之 上 。 而 搭载 安 卓 系统 的 智能 手机 ， 也 从 仅 含 通话 、 上 网 等 基本 功能 的 通信 
工具 ， 逐 渐 演化 成 集 拍照 、 定 位 、 社 交 、 支 付 等 生活 服务 为 一 身 的 全 能 小 秘书 。 

有 鉴于 此 ， 本 书 玻 需 补充 这 期 间 风 起 云 涌 的 新 技术 新 知识 ， 以 跟 上 时 代 发 展 的 滔滔 浪潮 。 
种 种 机 缘 际会 , 加 上 第 一 版 读者 的 热忱 建议 , 因此 便 有 了 重新 修订 之 后 的 本 书 第 三 版 问世 。 第 
二 版 图 书 不 是 第 一 版 的 简单 更 新 , 而 是 百 炼 成 钢 的 全 面 升级 , 与 第 一 版 相 比 , 第 二 版 图 书 主要 
有 以 下 五 处 重要 的 增补 变化 : 

1. 工具 更 新 颖 


第 二 版 的 App 开发 全 部 基于 Android 9.0 环境 ， 使 用 的 开发 工具 为 2018 年 9 月 发 布 的 
Android Studio 3.2，JNI 用 到 的 NDK 则 为 2018 年 6 月 发 布 的 rl7c。 相 关 的 功能 点 都 根据 上 述 
最 新 版 本 的 工具 展开 论述 ， 比 如 Android 8 新 增 的 画 中 画 功能 、Android 9 新 增 的 WebP 动 图 播 
放 、Android Studio 3 新 增 的 内 存 用 量 查看 窗口 ， 以 及 NDK 的 r17 不 再 支持 ARMS (armeabi) 
的 so 文件 编译 等 。 

2. 技术 更 先进 


移动 互联 网 的 后 继 发 展 方向 如 物 联网 、 虚 拟 现实 、 人 工 智 能 等 如 火 如 蔡 , 第 二 版 为 此 投入 
了 大 量 笔墨 深入 描述 相关 技术 细节 ， 例 如 物 联 网 涉及 到 的 二 维 码 、NFC、 红 外 、 蓝 牙 等 ， 虚 拟 
现实 涉及 到 的 陀螺 仪 、 三 维 图 形 、 全 景 照片 等 ， 人 工 智能 涉及 到 的 TTS、 语 音 识别 、 语 音 合 
成 等 ， 还 有 最 新 科研 成 果 如 北斗 导航 、SM3 国 密 等 ， 本 书 都 有 专门 章节 加 以 叙述 。 

3. 案例 更 丰富 


本 书 的 一 大 特色 是 突出 实战 , 每 章 末尾 都 给 出 了 技术 精炼 的 实战 项 目 。 第 二 版 更 是 将 这 个 
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优良 传统 发 扬 光 大 ， 除 了 原 有 的 十 几 个 实战 项 目 之 外 ， 又 对 房贷 计算 器 、 万 年 历 影视 播放 器 
等 开辟 专门 章节 详细 描述 ， 另 外 新 增 了 电 商 头 部 、 应 用 超市 、 全 景 图 库 、 矢 量 动画 、 电 子 书架 
等 全 新 的 实战 项 目 ， 力 图 把 常见 的 App 种 类 一 网 打 尽 。 

4. 代码 更 易 懂 

作为 一 部 软件 开发 方面 的 专著 , 少不了 给 出 范例 代码 进行 演示 , 代码 可 读 易 懂 的 重要 性 组 
庸 置 疑 。 第 二 版 在 这 方面 大 力 改善 ， 首 先 对 书 中 的 代码 全 面 添加 注释 ， 务 求 让 读者 看 得 懂 、 学 
得 会 ; 其 次 ， 针 对 Android 不 同系 统 之 间 的 方法 差异 ， 分 别 说 明 每 个 版 本 的 代码 兼容 处 理 ; 再 
次 ， 在 实战 项 目 示 例 中 ， 讲 清楚 每 个 代码 的 业务 逻辑 ， 以 及 它们 之 间 的 相互 关系 。 

5. 编排 更 合理 


第 一 版 对 个 别 知识 点 的 编排 不 其 合理 ， 第 二 版 对 这 些 知识 点 重新 组 织 编排 ， 使 之 更 连贯、 
更 系统 。 比 如 内 容 提供 器 ContentProvider 原来 只 在 第 13 章 做 介绍 ， 再 版 之 后 将 其 提前 到 第 4 
章 的 数据 存储 中 进行 介绍 ， 然 后 分 别 在 第 6 章 、 第 10 章 、 第 13 章 的 实战 项 目 中 加 以 运用 ， 有 
助 于 不 断 地 巩固 和 提高 。 又 如 蓝牙 BlueTooth 原本 只 在 第 14 章 的 一 个 小 节 中 作 介绍 ， 再 版 之 
后 将 其 提前 到 第 9 章 的 短 距离 通信 中 进行 介绍 , 然后 分 别 在 第 9 章 的 实战 项 目 蓝牙 音箱 ,以 及 
第 14 章 的 蓝牙 传输 中 加 以 运用 ， 从 而 拓宽 了 这 些 技术 的 应 用 场景 。 

综 上 所 述 , 经 过 精心 修订 的 第 二 版 图 书 , 无 论 是 广度 还 是 深度 ， 从 数量 到 质量 ， 都 比 第 一 
版 有 了 飞跃 的 提升 。 全 书 的 写作 目的 ， 不 但 是 教会 读者 怎么 快速 开发 一 个 好 玩 、 好 看 、 好 用 的 
App， 更 是 让 读者 领略 行业 前 沿 的 移动 互联 网 学 科 。 深 度 揭秘 流行 App 背后 的 手机 开发 技术 ， 
展示 移动 信息 科技 的 最 新 工程 实践 ， 这 才 是 第 二 版 想 要 呈献 给 读者 的 知识 盛宴 。 

第 二 版 的 所 有 代码 都 基于 Android Studio 3.2 开发 ， 并 使 用 API28 的 SDK (Android 9.0) 
编译 与 调试 通过 。 读 者 在 阅读 本 书 时 ， 若 对 书 中 内 容 有 任何 疑问 ， 均 可 在 笔者 的 CSDN 博客 

(http://blog.csdn.net/aqi00〉 留言 。 也 可 关注 笔者 的 微 信 公 众 号 “ 老 欧 说 安 卓 ”， 更 快 更 方便 

地 阅读 技术 干货 。 至 于 本 书 的 最 新 源码 ， 则 可 访问 笔者 的 github 主页 获取 ，github 地 址 是 
https://github.com/aqi00/android2; 也 可 访问 百度 网 盘 下 载 ， 下 载 页 面 是 https://pan.baidu.com/s/ 
14NE2DD-ffXxuDXUAITfRaw (注意 区 分 数字 和 大 小 写 ) 。 


最 后 , 感谢 王 金 柱 编辑 的 热情 指点 , 感谢 出 版 社 同仁 的 辛勤 工作 ,感谢 我 的 家 人 一 直 以 来 
的 支持 ， 感 谢 各 位 师长 的 说 说 教导 ， 没 有 他 们 的 鼎力 相助 ， 本 书 就 无 法 顺利 完成 。 


欧阳 桌 
2018 年 10 上 月 
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移动 应 用 开发 又 称 App 开发 ， 是 近年 来 的 新 兴 软 件 开发 行业 。 基 于 手机 设备 的 特性 ，App 
开发 与 服务 器 开发 、 网 页 开发 等 传统 软件 开发 有 很 大 不 同 ， 将 App 开发 相关 技术 称 为 一 门 新 
兴学 科 也 不 为 过 。 

作为 一 门 学 科 ， 必 然 要 求 建立 一 套 理论 体系 ,这 个 理论 体系 应 当 具 有 普遍 性 与 适用 性 ,不 
会 随 着 工具 的 变迁 而 消亡 。App 开发 就 是 如 此 , 无论 使 用 Android 开发 还 是 iOS 开发 ， 所 采用 
的 技术 、 要 实现 的 功能 都 大 同 小 异 , 区别 在 于 需要 使 用 不 同 的 编程 工具 进行 开发 。 对 于 用 户 来 
说 , 华为 手机 上 的 微 信 与 苹果 手机 上 的 微 信 都 是 社交 App, 这 两 个 微 信 在 功能 和 使 用 上 并 没有 
显著 区 别 。 

笔者 从 事 软 件 开 发 工作 十 几 年 ， 期 间 经 历 了 多 次 编程 方向 的 转型 ， 先 从 C/C++ 开发 转向 
Java 开发 ， 再 从 Java 开发 转向 Android 开发 ， 而 Android 开发 先 用 ADT 后 用 Android Studio。 
在 多 次 转型 过 程 中 , 笔者 深 深 体会 到 , 无 论 是 编程 语言 还 是 开发 工具 ， 变 化 的 都 是 技术 实现 手 
段 , 而 不 是 人 类 愿景 和 系统 原理 。 人 类 愿景 是 让 生活 更 加 便捷 、 让 娱乐 更 加 丰富 ， 系 统 原理 是 
让 软件 界面 更 加 美观 、 让 运行 速度 更 加 流畅 。 

本 书 的 写作 目的 是 教会 读者 Android 开发 ， 带 领 读 者 走 进 一 个 轩 新 的 学 科 领 域 。 市 面 上 的 
Android 开发 书籍 林林总总 ， 写 作风 格 各 有 千秋 ， 不 过 讲解 的 基本 是 编程 开发 ， 有 的 还 会 讲解 
项 目 管理 。 本 书 除 了 介绍 常规 的 Android 开发 外 ， 还 尝试 从 两 方面 加 以 拓展 ， 一 方面 从 产品 经 
理 的 角度 仔细 分 析 App 技术 能 帮 用 户 做 什么 事情 、 能 带 给 用 户 什 么 收获 ， 另 一 方面 从 设计 师 
的 角度 详细 论述 如 何 把 千篇一律 的 页 面 变 得 生动 活泼 ， 如 何 让 某 个 功能 实现 得 更 合理 、 高 效 。 

全 书 的 内 容 编排 采用 由 浅 入 深 、 循序 渐进 的 章节 体例 , 不 但 考虑 初学 者 的 学 习 连 续 性 , 而 
且 可 以 建立 一 个 统一 、 连 贯 的 学 科 体 系 。 这么 编排 的 好 处 是 显而易见 的 , 读者 只 要 按照 顺序 学 
习 , 就 能 在 学 习 过 程 中 对 已 学 部 分 不 断 复习 巩固 ,同时 提前 预习 后 面 的 技术 点 , 一 方面 衔接 自 
然 ， 另 一 方面 提高 学 习 效率 。 比 如 第 3 章 末尾 介绍 实战 项 目 “ 登 录 App”， 紧 接着 第 4 章 开头 
介绍 如 何 实 现 登 录 页 面 的 记 住 密码 功能 ， 第 12 章 介绍 “动画 ”， 一 方面 为 前 一 章 的 飞 掠 横幅 
补充 动画 效果 ， 另 一 方面 为 后 一 章 的 相册 切换 动画 埋 下 伏笔 。 

全 书 可 分 为 两 大 部 分 ， 第 一 部 分 是 第 1 一 8 章 ， 主 要 介绍 Android Studio 的 环境 搭建 ，App 
开发 的 各 种 常用 控件 ，App 的 数据 存储 方式 。 如 何 调试 App 并 将 App 发 布 上 线 ， 这 部 分 圳 括 


il} 
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了 App 开发 的 基础 知识 ， 特 别 详细 说 明 App 从 开发 到 调试 再 到 上 线 的 企业 级 开发 流程 。 第 二 
部 分 是 第 9 一 16 章 ， 主 要 介绍 App 开发 的 高 级 部 分 ， 包 括 设 备 操作 、 网 络 通信 、 事 件 、 动 画 、 
多 媒体 、 融 合 技 术 、 第 三 方 开发 包 、 性 能 优化 等 ， 这 部 分 涵盖 App 开发 的 进 阶 内容 ， 与 第 一 
部 分 相 比 就 像 是 “ 乌 枪 换 炮 ”， 让 开发 者 完成 从 游击 队 到 正规 军 的 华丽 转变 。 

建议 初学 者 和 在 校 学 生 完整 学 习 第 1 一 8 章 内 容 ， 因 为 这 部 分 包含 App 开发 的 必 备 技能 ， 
只 有 打 好 基础 , 才能 进一步 学 习 。 至 于 第 9 一 16 章 内 容 , 根据 前 面 的 学 习 情况 和 个 人 兴趣 爱好 
选择 相应 的 章节 学 习 即 可 。 如 果 倾 向 于 学 习 工 具 类 App 的 开发 ， 就 可 以 选择 学 习 “ 第 9 章 设 
备 操 作 ”“ 第 11 章 事件 ”“ 第 12 章 动画 ”“ 第 13 章 多 媒体 ”; 如 果 倾 向 于 学 习 企业 类 
App 的 开发 ， 就 可 以 选择 学 习 “ 第 10 章 网 络 通信 ” “第 14 章 融合 技术 ” “第 15 章 第 三 方 
开发 包 ” “第 16 章 性 能 优化 ”。 

对 于 有 经 验 的 开发 者 来 说 ， 可 以 自行 选择 不 熟悉 的 知识 点 拾遗 补缺 。 另 外 , 本 书 讲述 的 部 
分 知识 点 很 具 特 色 ， 如 卫星 导航 、Socket 通信 、 多 点 触 控 、 百 叶 窗 动画 、 音 乐 播放 器 、 蓝 牙 技 
术 、 支 付 SDK、 图 片 缓存 原理 等 ， 这 些 内 容 在 同类 Android 入 门 书籍 中 鲜 有 论述 ， 有 兴趣 的 
读者 可 重点 关注 。 

当然 , 本 书面 向 的 读者 不 仅 是 开发 人 员 和 计算 机 专业 学 生 , 也 包括 移动 互联 网 行业 的 其 他 
从 业 人 员 。 对 于 产品 经 理 来 说 ， 可 以 了 解 一 下 某 个 功能 使 用 的 技术 ， 看 似 简单 的 功能 ， 也 许 并 
不 容易 实现 。 对 于 设计 师 来 说 ，“ 他 山 之 石 ， 可 以 攻 玉 ”， 可 以 参考 一 下 别人 的 实现 方式 ， 也 
许 正好 可 以 激发 你 的 灵感 ， 其 实 不 无 神 益 。 对 于 测试 人 员 来 说 ， 可 以 熟悉 一 下 每 项 技术 的 优 缺 
点 ， 从 而 制订 出 更 全 面 的 测试 方案 ， 也 许 能 发 现 更 多 BUG 。 

本 书 所 有 代码 都 基于 Android Studio 2.2.3 开发 ， 并 使 用 API 25 的 SDK (Android 7.1.1) 
编译 与 调试 通过 。 读 者 在 阅读 本 书 时 ， 若 对 书 中 内 容 有 疑问 ， 可 在 笔者 的 博客 
(http://blog.csdn.net/aqi00) 留言 。 

本 书 范例 的 素材 和 代码 下 载 地 址 为 :http://pan.baidu.com/s/1dFEFEhF (注意 区 分 
数字 和 英文 字母 大 小 写 ) 。 如 果 下 载 有 问题 ， 请 发 送 电 子 邮 件 至 booksaga@126.com， 邮 
件 主题 设置 为 “ 求 从 零 基 础 到 App 上 线 下 载 资源 ”。 如 需 本 书 的 最 新 源码 ， 也 可 访问 作者 的 
github 主页 获取 ，github 地 址 是 https://github.com/aqi00/android2。 

最 后 , 感谢 王 金 柱 编辑 的 热情 指点 , 感谢 我 的 家 人 一 直 以 来 的 支持 , 没有 他 们 的 易 力 相助 ， 
本 书 就 无 法 顺利 完成 。 
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Android Studio 环境 搭建 


本 章 主 要 介绍 如 何在 个 人 电脑 上 安装 Android Studio 和 相应 的 配套 环境 , 并 通过 一 个 简单 
的 App“Hello World” 演 示 Android Studio 的 常用 操作 与 App 开发 、 运 行 的 流程 ， 还 介绍 了 
App 的 工程 结构 和 开发 过 程 中 的 准备 工作 。 


1.1 Android Studio 简介 


Android 是 基于 Linux 的 移动 设备 操作 系统 ， 中 文 名 为 安 卓 ， 主 要 用 于 智能 手机 与 平板 电 
脑 ， 现 已 拓展 至 互联 网 电视 、 可 穿戴 设备 、 车 载 终端 、 智 能 家 居 等 等 。Android 与 iOS 同 为 智 
能 手机 市 场 的 两 大 操作 系统 ， 但 安 卓 系统 的 全 球 市 场 份额 大 幅 领先 于 苹果 。 在 中 国 大 陆 ， 
Android 的 市 场 份额 更 是 遥遥 领先 ， 据 2018 年 4 月 的 移动 系统 调研 报告 ，Android 在 中 国 的 市 
场 份 额 为 86%， 其 余 份 额 为 iDS。 

早期 , 在 Android 下 开发 App 主要 使 用 Eclipse 和 基于 Eclipse 的 ADT。 不 过 Eclipse 毕竟 
是 为 Java 工程 而 生 的 开发 平台 ， 并 非 专门 用 于 Android， 所 以 先天 性 不 足 难以 避免 。 自 2015 
年 之 后 ， 谷 歌 公 司 便 停止 了 ADT 的 版 本 更 新 ， 转 而 重点 打造 自家 的 Android Studio。 

Android Studio 是 谷歌 公司 推出 的 Android 应 用 开发 环境 ， 与 基于 Eclipse 的 ADT 不 同 ， 
Android Studio 是 个 全 新 的 开发 环境 , 拥有 更 强大 的 功能 和 更 高 效 的 性 能 。 本 书 使 用 的 Android 
Studio 为 2018 年 4 月 发 布 的 3.1.2 版 本 ， 同 时 支持 Windows、Mac OS X 和 Linux。 

使 用 Android Studio 比 起 使 用 Eclipse 开发 有 如 下 好 处 : 


(1) Android Studio 使 用 v7 库 与 design 库 等 只 需 增 加 一 行 配 置 ， 而 Eclipse 要 想 使 用 这 
些 库 得 引用 整个 工程 。 

(2) 高 版 本 的 SDK 与 NDK 只 支持 Android Studio， 不 支持 Eclipse。 

(3) 更 多 新 功能 只 能 在 Android Studio 中 运用 ， 如 自动 保存 、 多 渠道 打包 、 整 合 版 本 管 
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理 、 支 持 预 览 drawable 图 形 文件 等 。 
1.2 ”Android Studio 的 安装 


既然 Android Studio 有 众多 优点 , 又 是 App 开发 大 趋势 的 主流 工具 , 接 下 来 就 让 我 们 一 步 
- 步 地 在 自己 的 电脑 上 安装 Android Studio 。 


1.2.1 开发 机 配置 要 求 


工 欲 善 其 事 ， 必 先 利 其 器 。 要 想 保 证 Android Studio 的 运行 速度 ， 开 发 用 的 电脑 配置 就 要 
跟 上 。 现 在 一 般 用 笔记 本 电脑 开发 App， 下 面 是 开发 机 的 基本 配置 : 

(1) 内 存 最 低 要 求 4GB， 推 荐 8GB， 越 大 越 好 。 

(2) CPU 要 求 1.5GHz 以 上 ， 越 快 越 好 。 

(3) 硬盘 要 求 系统 盘 剩 余 空间 10GB 以 上 ， 越 大 越 好 。 

(4) 要 求 带 无 线 网 卡 、 摄 像 头 ，USB 与 麦克 风 正 常 使 用 。 

(5) 如 果 操 作 系统 是 Windows， 那 么 至 少 为 Windows 7， 不 支持 Windows XP 。 


1.2.2 ”安装 依赖 的 软件 


Android Studio 作为 Android 应 用 的 开发 环境 ， 仍 然 依赖 于 JDK、SDK 和 NDK 三 种 开发 
下 具 。 
1. JDK 


JDK 是 Java 语言 的 编译 器 ,全称 为 Java Development Kit, 即 Java 开发 工具 包 。 因 为 Android 
应 用 采用 Java 语言 开发 ， 所 以 开发 机 上 要 先 安装 JDK， 下 载 地址 为 http://www.oracle.com/ 
technetwork/java/javase/downloads/index.html。JDK 建议 安装 1.8 及 以 上 版 本 ， 原 因 是 不 同 的 
Android 版 本 对 JDK 有 相应 的 要 求 ， 如 Android 5.0 默认 使 用 jdk1.7 编译 ，Android 7.0 默认 使 
用 jdk1.8 编译 。 

如 果 JDK 为 1.6 或 1.7， 而 SDK 为 最 新 版 本 ， 就 可 能 导致 如 下 问题 : 


(1) 创建 项 目 后 ， 浏 览 布 局 文件 设计 图 时 会 报错 Android N requires the IDE to be running 
with Java 1.8 or later。 

(2) 编译 项 目 失 败 ， 提 示 错 误 com/android/dx/command/dexer/Main: Unsupported 
major.minor version 52.0。 

(3) 运行 App 失败 ， 提 示 错 误 compileSdkVersion 'android-24' requires JDK 1.8 or later to 
compile. 

装 好 JDK 后 , 还 要 在 环境 变量 的 系统 变量 中 添加 JAVA_HOME, 取 值 为 JDK 的 安装 目录 ， 

例如 D:\Program Files(x86)\Javaijdk1.8.0 102 。 添 加 系统 变量 CLASSPATH ， 取 值 
为 .:%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\bin。 并 在 系统 
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变量 Path 末尾 添加 ;%JAVA_HOME%\bin。 
2. SDK 


SDK 是 Android 应 用 的 编译 器 ， 全 称 为 Software Development Kit， 即 软件 开发 工具 包 。 
SDK 提供 了 App 开发 的 常用 工具 合集 ， 主 要 包括 : 


。 build-tools 目录 ， 存 放 各 版 本 Android 的 各 种 编译 工具 。 

e@ docs 目录 ， 存 放 开 发 说 明文 档 。 

e@ extras\android 目录 ， 存放 兼容 低 版 本 的 新 功能 支持 库 ， 比 如 android-support-v4.jar、v7 

的 各 种 支持 库 、v13 以 上 兼容 库 等 。 

e@ platforms 目录 ， 存 放 各 版 本 Android 的 资源 文件 。 

@ platform-tools 目录 与 tools 目录 , 存放 常用 的 开发 辅助 工具 , 如 数据 库 管理 工具 sqlite3.exe、 

模拟 器 管理 工具 emulator.exe。 

e@ samples 目录 ， 存 放 各 版 本 Android 常用 功能 的 demo 源码 。 

e@ Sources 目录 ， 存 放 各 版 本 Android 的 API 开放 接口 源码 。 

esystem-images 目录 ， 存 放 模 拟 器 各 版 本 的 系统 镜像 与 管理 工具 。 

SDK 可 以 单独 安装 , 也 可 以 与 Android Studio 一 起 安装 , 单独 安装 的 下 载 页 面 入 口 地 址 是 
http://sdk.android-studio.org/。 建 议 通过 Android Studio 安装 SDK， 因 为 这 样 避免 了 一 些 兼 容 性 
与 环境 设置 问题 。 无 论 是 单独 安装 还 是 一 起 安装 ， 装 好 SDK 后 都 要 在 环境 变量 的 系统 变量 中 
添加 ANDROID_HOME， 取 值 为 SDK 的 安装 目录 ， 例 如 D:\Android\sdk。 并 在 系统 变量 Path 
末尾 添加 ;%ANDROID_HOME%\tools。 


3. NDK 


NDK 是 C/C++ 代码 的 编译 器 ， 全 称 为 Native Development Kit， 意 即 原生 开发 工具 包 。 该 
工具 包 主 要 供 JNI 接口 使 用 ， 先 把 C/C++ 代码 编译 成 so 库 ， 然 后 由 Java 代码 通过 JNI 接口 调 
用 so 库 。 

NDK 的 详细 安装 步骤 见 第 14 章 的 “14.2.1 NDK 环境 搭建 ”。 装 好 NDK 后 ， 要 在 环境 变 
量 的 系统 变量 中 添加 NDK_ROOT, 取 值 为 NDK 的 安装 目录 ,例如 D:\Android\android-ndk-r17。 
然后 在 系统 变量 Path 末尾 添加 ;%NDK_ROOT%。 


1.2.3 安装 Android Studio 


2016 年 12 月 8 日 ， 谷 歌 开发 者 的 中 文 网 站 上 线 了 。 国 内 开发 者 可 直接 在 该 网 站 下 载 
Android Studio, 详细 的 下 载 页 面 是 https://developer.android.google.cn/studio/index.html, 在 这 里 
可 以 找到 Android Studio 的 使 用 教程 。 

双击 下 载 完成 的 Android Studio 安装 程序 ， 弹 出 安装 界面 ， 如 图 1-1 所 示 。 全 部 勾 选 安装 
界面 中 的 选项 ， 然 后 单 击 Next 按钮 。 进 入 下 一 页 的 安装 路 径 配 置 页 面 ， 如 图 1-2 所 示 ， 建 议 
将 Android Studio 装 在 除 系统 盘 外 的 其 他 磁盘 〈 比 如 D 盘 ) ， 然 后 单 击 Next 按钮 。 

接 下 来 一 路 单 击 Next 按钮 ， 直 到 弹出 最 后 一 页 ， 单 击 Install 按钮 ， 等 待 安装 过 程 进行 。 
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1-1 Android Studio 的 安装 界面 图 1-2 选择 Android Studio 的 安装 目录 


安装 完毕 会 跳 到 Android Studio 的 安装 向 导 界 面 , 如 图 1-3 所 示 。 单 击 Next 按钮 进入 下 一 
页 ， 如 图 1-4 所 示 。 这 里 保持 Standard 选项 ， 单 击 Next 按钮 ， 在 配置 界面 确认 SDK 的 安装 路 
径 是 否 正确 ， 确 认 完 毕 继续 单 击 Next 按钮 ; 在 最 后 一 个 向 导 界 面 单 击 Finish 按钮 ， 等 待 设置 
操作 。 接 下 来 的 下 载 界面 会 自动 跳 转 到 谷歌 网 站 更 新 组 件 ， 这 里 直接 单 击 Cancel 按钮 取消 下 
载 ， 然 后 单 击 Finish 按钮 结束 设置 。 最 后 弹出 Welcome to Android Studio 欢迎 界面 ， 如 图 1-5 
所 示 。 单 击 第 一 项 的 Start a new Android Studio project 即 可 开始 你 的 Android 开发 之 旅 。 









ed mh the ort eaen senrtnes and Proms, 


图 1-3 安装 向 导 一 图 1-4 ”安装 向 导 二 


Android Studio 


Stare vee Mretd srodte trodeer 


1-5 Android Studio 的 欢迎 界面 
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注意 ， 配 置 过 程 可 能 发 生 如 下 错误 提示 : 

(1) 第 一 次 打开 Android Studio 可 能 会 报错 Unable to access Android SDK add-on list， 这 
个 界面 不 用 理会 ， 单 击 Cancel 按钮 即 可 。 进 入 Android Studio 主 界面 后 ， 依 次 选择 菜单 File 
一 Project Structure 一 SDK Location， 在 弹出 的 窗口 中 分 别 设置 JDK、SDK、NDK 的 路 径 。 设 
置 完 毕 后 再 打开 Android Studio 就 不 会 报错 了 。 

(2) 已 经 按照 安装 步骤 正确 安装 ， 运 行 Android Studio 却 总 是 打 不 开 。 请 检查 电脑 上 是 
否 开 启 了 防火 墙 ， 建 议 关 闭 系统 防火 墙 及 所 有 杀毒 软件 的 防火 墙 。 关 了 防火 墙 后 再 重新 打 
Android Studio 试 试 。 


1.2.4 下 载 Android 的 SDK 


从 Android Studio 3.0 开始 ， 官 网 放出 来 的 Android Studio 安装 包 都 不 带 SDK， 因 此 首次 
安装 AS 的 开发 者 还 要 另行 下 载 App 开发 需要 的 SDK。 此 外 ， 随 着 Android 版 本 的 更 新 换代 ， 
编译 工具 与 平台 工具 等 也 需 时 常 在 线 升 级 ， 故 而 接 下 来 介绍 如 何 下 载 最 新 的 SDK 平台 及 相关 
工具 。 

在 Android Studio 主 界面 ， 依 次 选择 菜单 Tools 一 SDK Manager， 菜 单 路 径 如 图 1-6 所 示 。 

















VCS VWindow Help 
风 AVD Manager 


~ SDK Manager 
Tasks & Contexts 
IDE Scripting Console 
区 Kotlin 





1-6 打开 SDK Manager 的 菜单 路 径 


此 时 弹出 Android SDK 的 管理 界面 ， 窗 口 右 边 是 一 大 片 的 SDK 配置 信息 ， 初 始 画面 如 图 
1-7 所 示 。 其 中 Android SDK Location 一 栏 可 单 击 右 侧 的 Edit 链接 ， 进 而 选择 SDK 下 载 后 的 
保存 路 径 。 其 下 的 三 个 选项 卡 默 认 显示 SDK Platforms， 也 就 是 各 个 SDK 平台 的 版 本 列表 , 勾 
选 每 个 列表 项 左边 的 复 选 框 ， 则 表示 需要 下 载 该 版 本 的 SDK 平台 ， 然 后 单 击 OK 按钮 即 可 自 
动 进行 SDK 的 下 载 安装 操作 。 也 可 单 击 中 间 的 选项 卡 SDK Tools， 单 击 后 切换 到 SDK 工具 的 
管理 列表 ， 如 图 1-8 所 示 。 在 这 个 工具 管理 界面 ， 能 够 在 线 升级 编译 工具 Build Tools、 平 台 工 
具 Platform Tools， 以 及 开发 者 需要 的 其 他 工具 。 
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1-7 SDK 平台 的 管理 列表 1-8 ”SDK 工具 的 管理 列表 
1.3 ”运行 小 应 用 Hello World 


成 功 安装 Android Studio 后 ， 打 开 其 界面 会 发 现 有 一 堆 菜单 和 图 标 ， 对 于 这 个 陌生 的 开发 
环境 , 读者 可 能 会 有 不 知 所 措 的 感觉 。 现在 不 再 逐一 讲解 每 个 菜单 和 图 标的 作用 ， 直 接 开 始 第 
-个 App 一 一 Hello World， 让 我 们 在 实践 中 边 学 边 用 ， 更 好 地 理解 和 吸收 。 


1.3.1 创建 新 项 目 


打开 Android Studio， 依 次 选择 菜单 File 一 New 一 New Project， 弹 出 Create New Project 窗 
口 ， 如 图 1-9 所 示 。 在 Application name 栏 输入 应 用 名 称 ， 在 Company Domain 栏 输入 公司 域 
名 ， 下 面 会 自动 合成 工程 的 包 名 ， 选 择 好 项 目 工程 的 保存 目录 ， 单 击 Next 按钮 。 

下 一 个 界面 是 目标 设备 界面 , 如 图 1-10 所 示 。 该 界面 可 选择 App 期 望 运行 在 什么 设备 上 ， 
以 及 运行 App 所 需 的 SDK 最 低 版 本 号 , Minimun SDK 右 下 方 的 文字 提示 当前 版 本 号 支持 的 设 
备 市 场 份额 。 这 里 不 做 变动 ， 按 照 默 认 色 选 的 Phone and Tablet 即 可 ， 最 低 版 本 号 也 是 默认 的 
API 16 (支持 设备 的 市 场 份额 为 99.2%， 能 够 满足 绝 大 部 分 机 型 ) 。 


一 


oa 





1-9 创建 新 项 目 1-10 指定 目标 设备 


第 1 章 Android Studio 环境 搭建 | 7 





然后 单 击 Next 按钮 , 进入 下 一 个 界面 , 如 图 1-11 所 示 。 该 界面 提示 请 选择 初始 界面 风格 ， 
这 里 还 是 保持 默认 的 选项 Empty Activity， 单 击 Next 按钮 。 
下 一 个 界面 是 入 口 设置 界面 ， 如 图 1-12 所 示 。 该 界面 可 输入 活动 名 称 (Activity Name) 
与 布局 名 称 (Layout Name) ， 正 常情 况 使 用 默认 名 称 即 可 ， 单 击 OK 按钮 ， ld 











图 1-11 指定 Activity 界面 的 风格 图 1-12 设置 入 口 界面 的 名 称 


工程 创建 完毕 后 ，Android Studio 自动 打开 activity_main.xml 与 MainActivityjava， 并 默认 
展示 MainActivityjava 的 源码 ， 如 图 1-13 所 示 。 


更 HelloWorld - IF;\StudioProjects\elioNorid] ~ Tapp] ~ ... \app)src\nain\... Cue 

















Ele Edit Viev Navigate Code Analyze Refactor Build Run Iools VCS Vindow Help || 
Helloyorld ) 导 op 人 IEappzjP 关上 0 宇 宇 加 RGA 
+ ct vt | OnairActivity. ia je 人 
中 
1 package con. exaxple. hellovorld, 
四 
s laport ... | 
站 
里 publie class Iainietivity eztends AppConpathctivity { 
3 了 
Y QOverride 3 
对 protected vold oncreate [Eundle savedInstanceState) { 上] 
-| super. onCreate(savedinstanceState) | 局 
二 setContentVier (R. layoat actidty man) 时 
1 ] | 
全 1009 == Loteat 下 由 3 a Version Contrel 国 Temnal 国 Gradle Co 
国 Gradle bull... 14:1 CRIF; js Cit: Masters Coniteit; ho coniexty 白 僵 多 








1-13 ”默认 创建 的 MainActivity 


MainActivity.java 上 方 的 标签 表示 该 文件 的 路 径 结 构 ， 注 意 源码 左 侧 有 一 列 标签 ， 从 上 到 
下 依次 是 Project、Structure、Captures、Favorites。 单 击 Project 标签 ， 左 侧 会 展开 小 窗口 表示 
该 项 目 工程 的 目录 结构 ， 如 图 1-14 所 示 。 单 击 Structure 标签 ， 左 侧 会 展开 小 窗口 表示 该 代码 
的 内 部 方法 结构 ， 如 图 1-15 所 示 。 


8 


思 Eelloyorld C3app Dsrc Dnain 中 java 日 


Captures 


册 


看 完 代码 文 件 再 来 看 布局 文件 ， 单 击 activity_main.xml 标签 , 切换 到 布局 文件 设计 展示 界 
面 ,如 图 1-16 所 示 。 可 以 看 到 左 侧 多 了 一 列 Palette 窗口 ,内 部 是 各 种 布局 与 控件 列表 。 在 Palette 
窗口 下 方 有 两 个 标签 ， 分 别 是 Design〈 默 认 选中 ， 表 示 设 计 图 ) 和 Text (表示 源 代码 ) 。 单 
击 Text 标签 ， 切 换 到 布局 文件 的 源码 界面 ， 如 图 1-17 所 示 。 这 个 布局 文件 是 标准 的 XML 格 


1: structue 大 
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Canellovorld C3app Dsrc Dlnain 门 ja 





TY Dnanifests 
大 Androi danifest. ml 
Y Djava 
上。 加 com. exanple.hellovorld 
> con. exanple.hellovorld (an 
上 con. exanple.hellovorld (test) 
v Cares 
四 travable 
上 拘 1ayout 
> nipnap 
* Evalues 
» [ernAssets 
上 (dcradle Scripts 


图 1-14 HelloWorld 的 工程 结构 





» 全 ?onCreate (Bundle): 


§ EE 


让 as @ 回 国 v © » 


Ob NainActivity 











图 1-15 MainActivity 的 方法 结构 


式 ， 内 部 定 sehal aa 


[=| 


加 区 小 站 团 全书 内 外 汶 脂 项 sze 短 硬 吕 1 


Caneliovorld Fase DJsre Dmin Fares lut Bactivity nin ml 


oerivity mtn ml » [WairAerivity jm x 


le Bie DY- Boome ei 人- 


tt eet 
网 swmll Tert 
putton 


下 mo 志 : hndrnid Wenttnr 。 国 Tamtnal 















口 同 代 #* 小 多国 向 忆 入 中 休 村 蔚 spP 委 沪 凡 个 帮 和 


i Dire Dre Din LD 站 layeor actity nin ml 








1-16 activity_ main.xml 的 设计 图 


1.3.2 ”编译 项 目 /模块 


Android Studio 与 Eclipse 一 样 ， 如 果 代码 没有 报错 


EECETIETP 





Form version="1. 0” encoding="utf-8"?» 
SO “aelativeLayout znlns:android="http://schemas. android. com/apk/res/android” 


xmlns: tools="http://schewss. android com/tools” 





tools:contert="com. eraaple. helloworld. KainActivity”> 


TertVien 
ondroid: layout midthr “wrap_content” 
smdroldr layout he 








EE 
其 0: wa 国 Tersinnl 。 填 5: hrcoid Romator 入 TOD 
orate vaild tintahed in Zs ems lz anmute we) 


Ls1 CLs Wf 


1-17 activity_main.xml 的 源 代码 


背 ，Android Studio 就 会 自动 编译 ， 我 们 


只 需 直 接 运 行 项 目 即 可 。 当 然 有 时 候 开 发 者 想 手动 重新 编译 ， 有 以 下 3 种 编译 方式 : 
(1) 选择 菜单 Build 一 Make Project， 编 译 整个 项 目下 的 所 有 模块 。 


(2) 选择 菜单 Build 一 Make Module ***， 
(3) 选择 菜单 Build 一 Clean Project， 然 后 选择 菜单 Build 一 Rebuild Project， 先 清理 项 目 ， 


再 对 整个 项 目 重新 编译 。 


编译 指定 名 称 的 模块 。 
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下 面 先 认识 一 下 任务 栏 上 的 几 个 常用 图 标 ， 后 面 会 经 常用 到 它们 。 
在 图 1-18 中 ， 倒 数 第 4 个 竖 屏 图 标 是 AVD Manager 
按钮 ， 单 击 该 按钮 会 弹 出 模拟 器 的 管理 窗口 ; 个 数 第 5 个 号 上 至 芒 名 QQ 
向 下 箭头 图 标 是 SDK Manager, 单 击 该 按钮 会 弹出 SDK 版 1-18 任务 栏 上 的 常用 图 标 
本 的 管理 窗口 。 


1.3.3 创建 模拟 器 


所 谓 模拟 器 ， 是 指 在 电脑 上 构造 一 个 演示 
窗口 ， 模 拟 手机 屏幕 上 的 App 运行 效果 。App 
通过 编译 后 ， 要 选择 一 个 接 入 设备 来 运行 ， 依 
次 选择 菜单 Run 一 Run 'app' (也 可 按 快捷 键 
ShifttF10〉 ，Android Studio 会 弹出 新 窗口 
Select Deployment Target， 如 图 1-19 所 示 。 

对 初学 者 来 说 ， 一 开始 没有 可 用 的 模拟 
器 ,得 创建 新 模拟 器 , 单 击 Create New Emulator 
按钮 ,弹出 横 拟 器 的 配置 界面 ,如 图 1-20 所 示 。 
按照 默认 配置 即 可 ， 单 击 Next 按钮 。 

下 一 个 界面 是 SDK 版 本 的 选择 界面 ， 如 图 1-21 所 示 。 单 击 第 3 个 标签 Other Images， 在 
列表 中 选择 第 一 个 Lollipop〈 即 Android 5.1) ， 表 示 接 下 来 创建 的 模拟 器 是 基于 Android 5.1 
系统 的 。 然 后 单 击 Next 按钮 ， 进 入 最 后 的 确认 界面 ， 在 确认 界面 右 下 角 单 击 Finish 按钮 ， 等 
待 模拟 器 的 创建 。 


elect DIRECT 





Wo USB devices or running enulators detected Troubleshoot 


Conn: 








| Create Nev Enulator 


DUse sane selection for future launches Cancel 
图 1-19 运行 App 选择 接 入 设备 

































图 1-20 选择 模拟 器 的 分 辩 率 图 1-21 选择 模拟 器 的 SDK 版 本 
1.3.4 ”在 模拟 器 上 运行 App 


模拟 器 创建 完成 后 ， 重 新 依次 选择 菜单 Run 一 Run 'app'， 这 时 弹出 的 窗口 中 会 出 现 刚才 创 
建 的 模拟 器 ， 名 称 为 Nexus 4 API 22， 如 图 1-22 所 示 。 
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图 1-22 接 入 设备 界面 出 现 新 创建 的 模拟 器 


选中 该 模拟 器 , 单 击 OK 按钮 , 等待 Android Studio 启动 模拟 器 。 关 于 模拟 器 的 启动 结果 ， 
可 以 查看 主 界面 下 方 的 提示 窗口 ， 如 图 1-23 所 示 。 提 示 窗 口 有 左右 两 个 小 窗口 ， 左 侧 窗口 的 
左上 角 有 一 个 logcat 标签 ,用 于 展示 App 的 运行 日 志 ; 右 侧 窗口 的 右 下 角 有 一 个 Gradle Console 
标签 ， 用 于 展示 App 工程 的 编译 与 启动 情况 。 


CESIC 












图 1-23 App 运行 结果 跟踪 窗口 
如 果 在 Gradle Console 窗口 提示 编译 或 启动 失败 ,就 按照 提示 信息 进行 处 理 。 如 果 Gradle 
Console 窗口 提示 成 功 ， 等 待 模拟 器 启动 完成 后 ， 就 会 出 现 类 似 手 机 的 模拟 器 界面 ， 如 图 1-24 
所 示 。 把 模拟 器 屏幕 下 方 中 间 的 解锁 图 像 向 上 拖 动 ， 使 得 屏幕 解锁 成 功 ， 这 时 进入 App 的 启 
动 界 面 Hello World， 如 图 1-25 所 示 。 


5654 Ven 4 KPI 到 53554: Nerus_4_JP1_22 WE 


Helloword 











图 1-24 ”模拟 器 启动 完成 屏幕 图 1-25 HelloWorld 的 启动 界面 
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如 果 App 启动 界面 正常 展示 ， 那 么 恭喜 你 ， 第 一 个 Hello World App 就 这 样 成 功 了 。 都 说 
万 事 开 头 难 ， 前 面 克服 了 各 种 困难 ， 终 于 搭建 好 Android Studio 的 开发 环境 ， 并 且 成 功 运行 了 
第 一 个 App 一 一 Hello World， 不 过 这 只 是 万 里 长 征 的 第 一 步 ， 接 下 来 还 有 更 奇妙 的 Android 世 
界 等 着 我 们 去 探索 。 


1.4 ”App 的 工程 结构 


上 一 节 在 模拟 器 上 成 功 地 运行 了 第 一 个 App (Hello World) ， 接 下 来 好 好 研究 一 下 它 的 
工程 结构 。 每 个 App 的 工程 结构 都 差不多 ， 只 要 掌握 了 基本 结构 ， 后 面 开 发 起 来 就 会 得 心 应 
手 。 


1.4.1 工程 目录 说 明 


Android Studio 的 工程 创建 分 两 个 层级 : 第 一 个 层级 通过 菜单 File 一 New 一 New Project 创 
建 ， 这 里 的 新 项 目 是 指 新 的 工作 空间 ， 对 应 Eclipse 的 workspace; 第 二 个 层级 通过 菜单 File 
一 New 一 New Module 创建 ， 这 里 的 新 模块 是 指 一 个 单独 的 App 工程 ， 对 应 Eclipse 的 project。 
第 一 次 运行 Android Studio 都 是 选择 New Project, 表示 先 创建 一 个 工作 空间 ; 后 面 还 想 创建 新 
的 App 工程 时 ， 只 需 选 择 New Module， 表 示 在 当前 工作 空间 下 新 建 一 个 App 工程 。 
例如 ， 图 1-26 是 之 前 HelloWorld 工程 的 目录 结构 图 。 
T app 


Y Dnanifests 
网 Androi danifest. ml 
Y Djava 
* con. exanple.hellovorld 
» con. eranple.hellovorld (an 中 
» con. exanple.hellovorld (test 
TY Cares 
加 travable 
* 后 layout 
» nipnap 
» 的 values 
Y (Dcradle Scripts 
他 build gradle (Project; Helloyorld 
他 build gradle (Wodule: ap 
目 proguard-rules. pro (Pr 
[eradle. properties (Froject Properties 
(Dd settings. gradle (P 
[i local. properties (SDK Locatior 








图 1-26 ”Hello World 工程 的 目录 结构 图 
从 结构 图 中 可 以 看 到 ， 该 工程 下 面 有 两 个 目录 : 一 个 是 app， 另 一 个 是 Gradle Scripts。 其 
中 ，app 下 面 又 有 3 个 子 目 录 ， 功 能 说 明 如 下 : 


(1) manifests 子 目录 ， 下 面 只 有 一 个 xml 文件 ， 即 AndroidManifestxml， 是 App 的 运行 
配置 文件 。 
(2) java 子 目 录 ， 下 面 有 3 个 com.example.hellorworld 包 ， 其 中 第 一 个 包 存放 的 是 App 
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工程 的 java 源 代 码 ， 后 面 两 个 包 存 放 的 是 测试 用 的 Java 代码 。 
(3) res 子 目录 ， 存 放 的 是 App 工程 的 资源 文件 。res 子 目 录 下 又 有 4 个 子 目 录 : 


drawable 目录 存放 的 是 图 形 描述 文件 与 用 户 图 片 。 
layout 目录 存放 的 是 App 页 面 的 布局 文件 。 
mipmap 目录 存放 的 是 启动 图 标 。 
values 目录 存放 的 是 一 些 常 量 定义 文件 ， 比 如 字符 串 常 量 strings.xml、 像 素 常量 
dimens.xml、 颜 色 常 量 colors.xml、 样 式 风格 定义 styles.xml 等 。 
Gradle Scripts 下 面 主要 是 工程 的 编译 配置 文件 ， 主 要 有 : 

(1) build.gradle， 该 文件 分 为 项 目 级 与 模块 级 两 种 ， 用 于 描述 App 工程 的 编译 规则 。 

(2) proguard-rules.pro， 该 文件 用 于 描述 java 文件 的 代码 混淆 规则 。 

(3) gradle.properties， 该 文件 用 于 配置 编译 工程 的 命令 行 参数 ， 一 般 无 须 改动 。 

(4) settings.gradle， 配 置 哪些 模块 在 一 起 编译 。 初 始 内 容 为 include ':app'， 表 示 只 编译 
App 模块 。 

(5) local.properties， 项 目的 本 地 配置 ， 一 般 无 须 改动 。 该 文件 是 在 工程 编译 时 自动 生成 
的 ， 用 于 描述 开发 者 本 机 的 环境 配置 ， 比 如 SDK 的 本 地 路 径 、NDK 的 本 地 路 径 等 。 


1.4.2 ”编译 配置 文件 build.gradle 


项 目 级 别 的 build.gradle 一 般 无 须 改 动 ， 读 者 只 需 关 注 模块 级 别 的 build.gradle。 下 面 在 初 
始 的 build.gradle 文件 中 补充 文字 注释 ， 方 便 读者 更 好 地 理解 每 个 参数 的 用 途 。 


apply plugin: 'com.android.application 





android { 
/ 指定 编译 用 的 SDK 版 本 号 。 如 28 表示 使 用 Android 9.0 编译 
compileSdkVersion 28 
// 指定 编译 工具 的 版 本 号 。 这 里 的 头 两 位 数字 必须 与 compileSdkVersion 保持 一 致 ， 具 体 的 版 本 号 
可 在 sdk 安装 目录 的 “sdk\build-tools” 下 找到 
buildToolsVersion "28.0.3" 


defaultConfig { 
/ 指定 该 模块 的 应 用 编号 ， 即 App 的 包 名 。 该 参数 为 自动 生成 ， 无 需 修 改 
applicationId "com.example.helloworld" 
/ 指定 App 适合 运行 的 最 小 SDK 版 本 号 。 如 16 表示 至 少 要 在 Android 4.1 上 运行 
minSdkVersion 16 
/ 指定 目标 设备 的 SDK 版 本 号 。 即 该 App 最 希望 在 哪个 版 本 的 Android 上 运行 
targetSdk Version 28 
// 指定 App 的 应 用 版 本 号 
versionCode 1 
/ 指定 App 的 应 用 版 本 名 称 


versionName "1.0" 
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buildTypes { 
release { 
// 指定 是 否 开 启 代码 混淆 功能 。true 表示 开启 混淆 ，false 表示 无 需 混淆 。 
minifyEnabled false 
/ 指定 代码 混淆 规则 文件 的 文件 名 
proguardFiles getDefaultProguardFile(proguard-android.txt), 'proguard-rules.pro' 
} 
b 


1 


/ 指定 App 编译 的 依赖 信息 
dependencies { 
// 指定 引用 jar 包 的 路 径 
implementation fileTree(dir: 'libs', include: ['*.jar]) 
// 指定 单元 测试 编译 用 的 junit 版 本 号 
testImplementation junit:junit:4.12" 
// 指定 编译 Android 的 高 版 本 支持 库 。 如 AppCompatActivity 必须 指定 编译 appcompat-v7 库 
implementation "com.android.support:appcompat-v7:28.0.0" 
| 


1.4.3 App 运行 配置 AndroidManifest.xml 


AndroidManifest.xml 用 于 指定 App 内 部 的 运行 配置 ， 是 一 个 XML 描述 文件 ， 根 节点 为 


manifest， 根 节点 的 package 指定 了 该 App 的 包 名 。manifest 下 面 又 有 若干 子 节点 ， 分 别 说 明 
如 下 : 


(1) uses-sdk， 该 节点 有 两 个 属性 : android:minSdkVersion 和 android:targetSdkVersion。 


这 两 个 属性 是 早期 Eclipse 开发 App 时 使 用 的 ， 现 在 这 两 个 字段 改 成 放 到 build.gradle 文件 中 ， 
故而 Android Studio 不 配置 uses-sdk 也 没有 关系 。 


(2) uses-permission， 该 节点 用 于 声明 App 运行 过 程 中 需要 的 权限 名 称 。 例 如 ， 访 问 网 


络 需要 上 网 权限 ， 拍 照 需要 摄像 头 权 限 ， 定 位 需要 定位 权限 等 。 


(3) application， 该 节点 用 于 指定 App 的 自身 属性 ， 默 认 的 属性 说 明 如 下 : 


e@ android:allowBackup， 用 于 指定 是 否 允 许 备份 ， 开 发 阶段 设置 为 true， 上 线 时 设置 为 


false。 
e@ android:icon， 用 于 指定 该 App 在 手机 屏幕 上 显示 的 图 标 。 
e@ android:label， 用 于 指定 该 App 在 手机 屏幕 上 显示 的 名 称 。 


eandroid:supportsRtl, 设置 为 true 表示 支持 阿拉 伯 语 /波斯 语 这 种 从 右 往 左 的 文字 排列 顺 


序 。 
e android:theme， 用 于 指定 该 App 的 显示 风格 。 


application 节点 下 还 有 几 个 子 节点 ， 比 如 活动 activity、 服 务 service、 广 播 接 收 器 receiver、 
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内 容 提 供 器 provider 等 ， 这 些 子 节点 的 详细 属性 会 在 后 续 章节 详细 说 明 。 
1.4.4 在 代码 中 操纵 控件 


在 一 开始 创建 Hello World 工程 时 ，Android Studio 默认 打开 了 两 个 文件 , 分 别 是 布局 文件 
activity_main.xml 和 代码 文件 MainActivity.java。 下 面 先 看 布局 文件 activity_main.xml 的 内 容 : 
<RelativeLayout xmiIns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:padding="(@dimen/activity_vertical_margin"> 


<!-- 这 是 个 文本 视图 ， 名 字 叫 做 tv_hello， 显 示 的 文字 内 容 为 “Hello World!” -> 
<TextView 
android:id="(@+id/tv_hello" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Hello World!" /> 
</RelativeLayout> 


这 里 可 以 看 到 xml 文件 中 只 有 两 个 节点 ,分 别 是 RelativeLayout 和 TextView。 再 仔细 看 看 ， 
有 没有 发 现 熟悉 的 “Hello World”? 没 错 , 模拟 器 App 界面 显示 的 Hello World 就 来 自 于 这 里 ， 
也 就 是 TextView 控件 的 android:text 属性 值 。 可 以 把 这 里 的 Hello World 改 为 其 他 文字 ， 比 如 
“你 好 、 世 界 ” 或 ILove Android,， 改 完 保存 文件 后 再 依次 选择 菜单 Run 一 Run 'app'， 看 看 App 
界面 上 的 文字 是 不 是 变 成 新 的 了 ? 
当然 ， 我 们 的 目标 并 不 仅 限于 在 布局 文件 中 修改 文字 ， 还 要 能 够 在 代码 中 修改 文字 的 内 
容 。 再 次 打开 代码 文件 MainActivityjava， 看 看 里 面 有 什么 内 容 。 该 java 文件 中 MainActivity 
类 的 内 容 如 下 : 


public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_main); 


} 


这 里 可 以 看 出 ，MainActivity.java 的 代码 内 容 很 简单 ， 只 有 一 个 MainActivity 类 ， 该 类 下 
面 只 有 一 个 函数 onCreate。 注 意 onCreate 内 部 的 setContentView 方法 直接 引用 了 布局 文件 的 名 
字 activity_main， 该 方法 的 意思 是 往 App 界面 填充 activity_main.xml 的 布局 内 容 。 现 在 我 们 要 
在 这 里 改动 改动 ， 加 点 “绿叶 红 花 ”让 它 好 看 一 些 。 首 先 打 开 activity_main.xml， 在 TextView 
节点 下 方 补充 一 行 android:id="@+id/tv_hello"; 然后 回 到 MainActivityjava， 在 setContentView 
方法 下 面 补充 几 行 代 码 ， 具 体 如 下 : 











第 1 章 ， Android Studio 环境 搭建 | 15 





public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
// 当前 的 页 面 布局 采用 的 是 res/layout/activity_main.xml 
setContentView(R.layout.activity_main); 
// 获取 名 叫 tv_hello 的 TextView 控件 
TextView tv_hello = fmdViewById(R.id.tv_hello); 
/ 设置 TextView 控件 的 文字 内 容 
tv_hello.setText(" 今 天 天 气 真 热 啊 ， 火 辣 辣 的 "); 
1/ 设置 TextView 控件 的 文字 颜色 
tv_hello.setTextColor(Color.RED); 
/ 设置 TextView 控件 的 文字 大 小 
tv_hello.setTextSize(30); 


} 

保存 文件 后 依次 选择 菜单 Run 一 Run 'app', 模拟 器 上 
的 App 界面 就 变 成 了 如 图 1-27 所 示 的 样子 。 

现在 不 但 文字 内 容 改 变 了 ， 文 字 颜 色 和 字体 大 小 也 
发 生 了 变化 。 怎 么 样 ， 是 不 是 很 有 成 就 感 呢 ? 好 的 开始 
是 成 功 的 一 半 , 现在 大 家 初步 学 会 了 在 代码 中 操作 控件 ， 
下 一 章 进一步 学 习 在 App 界面 上 人 机 交互 。 


1.5 “准备 开始 


俗话 说 得 好 ， 磨 刀 不 误 砍 柴 工 。 尽 管 前 面 我 们 已 经 
初步 学 会 了 通过 代码 操作 控件 ， 不 过 为 了 后 面 介绍 
Android 更 顺利 些 , 建议 读者 先 了 解 本 节 的 准备 工作 。 即 
使 已 经 迫不及待 要 进入 Android 的 开发 世界 ， 也 万 万 不 ” 图 1-27 
可 跳 过 本 节 直 接 翻 到 第 2 章 ， 心 急 可 吃 不 了 热 豆 腐 哦 。 


1.5.1 使 用 快捷 键 








EECOPL2 


今天 天 气 真 执 啊 ， 火 衙 闫 
的 


修改 文字 后 的 HelloWorld 界面 





就 像 在 Eclipse 上 进行 java 开发 一 样 , 善 用 快捷 键 会 让 开发 者 提高 工作 效率 , Android Studio 


也 是 一 样 ， 下 面 是 使 用 Android Studio 开发 App 常用 的 快捷 键 。 


e@ CtrltS: 保存 文件 。 
e CtrltZ: 撤销 上 次 的 编辑 。 


e CtrltShifttZ: 重 做 上 次 的 编辑 ， 建 议 改 为 CtrHHY， 与 Eclipse、UEStudio 等 工具 保持 
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1.5.2 
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一 致 。Android Studio 默认 CtrltY 为 删除 当前 行 ， 这 点 不 太 好 ， 当 你 习惯 按 Ctrl+Y 重 
做 上 次 编辑 时 ， 系 统 却 删除 了 当前 行 ， 非 常 不 便 。 

CtrlHC: 复制 。 

CtrlHX: 剪 切 。 

CtrlHV: 粘贴 。 

CtrlHA: 全 选 。 

Delete: 删除 。 

CtrltF: 查询 。 

CtrlHR: 替换 。 

CtrlH: 注释 选中 代码 (在 每 行 代码 前 面 加 双 斜 杆 ) 。 

CtrltShiftt/: 注释 选中 的 代码 段 (在 选中 的 代码 段 前 面 加 “/*”， 后 面 加 “*/”)。 
CtrltAlttL: 格式 化 选中 的 代码 段 . 注意 该 快捷 键 与 QQ 默认 的 热 键 (锁定 QQ ) 冲突 ， 
建议 更 换 快 捷 键 ， 或 者 删除 QQ 的 同名 热 键 。 

Shift+F6: 重 命名 。 建 议 改 为 F2， 与 Wnidows 和 Eclipse 的 使 用 习惯 保持 一 致 。 
Alt+Enter: 给 光标 所 在 位 置 的 类 导入 相应 的 包 。 

Shift+F10: 运行 当前 模块 。 

Ctrl+F5: 清理 并 重新 运行 当前 模块 。 


当然 ， 每 个 人 习惯 的 快捷 键 不 尽 相同 ， 对 于 Android Studio 来 说 也 不 例外 ， 为 了 更 好 地 使 
用 快捷 键 ， 最 好 手工 修改 快捷 键 。 手 工 修改 快捷 键 的 方法 : 依次 选择 菜单 File 一 Settings， 在 
弹出 的 设置 窗口 中 选择 Keymap， 窗 口 右 侧 出 现 如 图 1-28 所 示 的 快捷 键 列表 。 


全 Scinas Ne 






» Other Settings 












































1-28 快捷 键 设置 界面 


在 设置 界面 选中 某 条 快捷 键 ， 右 击 或 单 击 上 方 的 铅笔 按钮 ， 在 弹出 的 菜单 中 选择 Add 
Keyboard Shortcut， 然 后 在 键盘 上 按 你 要 设置 的 快捷 键 组 合 ， 单 击 OK 按钮 ， 即 可 完成 对 应 的 
快捷 键 设置 。 


安装 SVN 工具 


在 企业 里 面 开发 App 都 是 团队 合作 ， 需 要 对 代码 进行 统一 管理 ， 而 且 App 每 隔 一 两 周 便 


第 1 章 Android Studio 环境 搭建 | 17 





发 布 一 个 新 版 本 ， 这 也 要 求 做 好 工程 代码 的 版 本 控制 。 因 此 ， 企 业 开 发 App 都 会 运用 版 本 控 
制 工具 管理 工程 源码 ， 最 常见 的 版 本 控制 工具 是 SVN。 

Android Studio 自 带 了 SVN 插件 (Subversion) ， 但 是 还 需要 开发 者 进行 相关 配置 才能 正 
常 使 用 SVN 功能 。 具 体 配 置 步 又 如 下 : 


TI01 在 本 机 上 安装 TortoiseSVN。 

首先 下 载 TortoiseSVN 安装 包 , 然后 在 安装 时 选择 command line client tools, 这 样 安装 后 在 bin 
目录 下 才能 找到 命令 行 工具 svn.exe。 

本 D02 在 Android Studio 中 配置 TortoiseSVN 的 命令 行 工具 。 

打开 Android Studio， 依 次 选择 菜单 File 一 Settings 一 Version Control 一 Subversion 一 user 
command line client， 单 击 右 侧 的 浏览 按钮 ， 选 择 本 地 安装 的 svn.exe 的 完整 路 径 。 

JI03 在 Android Studio 中 使 用 SVN 检 出 项 目 。 

打开 Android Studio， 依 次 选择 菜单 VCS 一 Checkout from Version Control 一 Subversion， 单 击 
Repositories 右 方 的 加 号 按钮 ， 在 弹出 的 小 窗口 中 输入 SVN 仓库 地 址 ， 单 击 OK 按钮 ， 回 到 原 窗 
单 击 Checkout 按钮 ， 把 项 目 检 出 到 本 地 目录 。 


项 目 检 出 完毕 后 , 在 开发 过 程 中 要 及 时 把 改 好 的 代码 提交 到 SVN, 同时 要 及 时 从 SVN 更 
新 别人 改过 的 代码 到 本 地 。 下 面 是 SVN 更 新 /提交 的 方法 : 
(1) 把 代码 提交 给 SVN 服务 器 :选中 并 右 击 工程 目录 ,依次 选择 菜单 Subversion 一 Commit 
File...， 表 示 向 SVN 服务 器 提交 本 地 改过 的 文件 。 
(2) 从 SVN 服务 器 更 新 代码 : 选中 并 右 击 工程 目录 ， 依 次 选择 菜单 Subversion 一 Update 
File...， 表 示 从 SVN 服务 器 更 新 文件 到 本 地 目录 。 


1.5.3 ”安装 常用 插件 


在 Android Studio 中 安装 插件 的 步骤 与 Eclipse 类 似 ， 具 体 步骤 为 :依次 选择 菜单 File 一 
Settings 一 Plugins 一 下 方 按钮 Browser repositories.… 弹出 当前 可 用 插件 列表 窗口 ,如 图 1-29 所 示 。 


一 
| 
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1-29 ”安装 插件 窗口 


在 安装 插件 窗口 的 Category 框 中 选择 Code tools， 然 后 选中 左边 列表 的 指定 插件 ， 再 单 击 
右边 窗口 内 部 的 Install 按钮 ， 安 装 后 重启 Studio 即 可 正常 使 用 该 插件 的 功能 。 下 面 是 5 个 常 
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用 的 Studio 插件 : 
1.Android Parcelable code generator 


该 插件 可 自动 生成 Parcelable 接口 的 代码 。 开 发 者 先 写 好 一 个 类 和 内 部 变量 的 定义 ， 然 后 
在 代码 中 按 AlttInsert， 弹 出 的 菜单 列表 下 方 就 有 Parcelable 选项 ， 如 图 1-30 所 示 。 选 中 该 选 
项 ， 即 在 类 中 插入 实现 Parcelable 接口 的 代码 。 


2. Android Code Generator 


该 插件 可 根据 布局 文件 快速 生成 对 应 的 Activity、Fragment、Adapter、Menu 等 代码 。 在 
布局 文件 上 右 击 或 者 在 布局 文件 内 部 右 击 ， 弹 出 的 菜单 中 多 了 一 个 Generate Android Code 选 
项 ， 有 具体 的 菜单 如 图 1-31 所 示 。 选 中 生成 项 后 ， 便 会 弹出 代码 窗口 ， 把 已 生成 的 代码 复制 出 
来 即 可 。 注 意 该 插件 对 汉字 的 支持 不 太 好 ， 如 果 XML 文件 中 有 汉字 ， 代 码 就 会 生成 失败 。 


ublic class Person { 
public String id 
public String name; 
public int apge; 
Generate 
Go To 
Cenerate... Alt+Insert 
@ open in Brovser 
Yalidate 


GsonFornat Alt+S 


Constructor 
Getter 
Setter 


Local History 


Getter and Setter Activity 


equals () and hashCode() 


Compare vith Clipboard 











toString() Fragnent 
Override Methods... Ctrl+0 Generate DID fron XML File Butterknife Activity 
Delegate Methods... Generate XSD Scheaa fron XNL File... Butterknife Adapter 
Copyright Butterknife Fragnent 
DO Create Gist... text 
1-30 ”Parcelable 插件 图 1-31 Generate Android Code 插件 菜单 


3. GsonFormat 

该 插件 能 够 快速 将 JSON 字符 串 转 换 成 代码 段 ， 包 含 变量 定义 以 及 set、get 函数 。 在 代码 
中 按 AlttrS， 弹 出 JSON 格式 化 窗口 ， 往 窗口 中 粘贴 JSON 字符 串 ， 单 击 OK 按钮 ， 即 可 在 代 
码 中 插入 生成 好 的 代码 段 。GsonFormat 窗口 如 图 1-32 所 示 。 





cronr ont La li 
com cmmgle hello. begscstjan Fp | 





eaep 1007, ] 
paraIType:2 "porlAcc ot Vest“portilp wd 123456° requestip” "127.0.0.1" nmi "1 





E33 ED 本 本 





图 1-32 ”GsonFormat 插件 
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4. Android Postfix Completion 


该 插件 支持 在 代码 中 快速 生成 Toast、Log 等 代码 行 。 开 发 者 在 代码 中 输入 字符 串 ， 后 面 
跟 上 .toast 并 回 车 ， 即 可 生成 ToastmakeText 代码 行 ， 输 入 字符 串 后 ， 紧 接着 输入 .log 并 回 车 ， 
即 可 生成 Log.d 代码 行 ， 如 图 1-33 所 示 。 











“调试 B 志 .lo 中 
] 
图 1-33 Postfix 插件 使 用 截图 


5. Android Drawable Importer 


该 插件 可 对 一 张 图 片 自动 生成 不 同 分 辩 率 的 图 片 ， 从 锭 Icon Pack Drawable Inporter 
而 让 图 片 对 不 同 屏幕 的 适 配 工作 变 得 更 加 容易 。 右 击 任意 ”于 Eee 
目录 ， 在 弹出 的 菜单 中 选择 New， 右 方 弹出 的 菜单 列表 未 en 
尾 会 出 现 *** Drawable Importer 之 类 的 菜单 项 ， 如 图 1-34 
所 示 ，。 图 1-34 Drawable 插件 菜单 

这 里 通常 选中 Batch Drawable Import， 在 弹出 的 窗口 中 选择 图 片 的 文件 路 径 ， 并 勾 选 需要 
自动 生成 的 分 状 率 ， 然 后 单 击 OK 按钮 ， 即 可 在 drawabe 各 分 辨 率 的 目录 下 生成 对 应 的 图 片 。 


1.5.4 ”导入 已 经 存在 的 工程 


初学 者 一 开始 学 习 App 开发 ， 免 不 了 想 借 鉴 他 人 的 编码 思路 ， 这 就 需要 将 网 上 的 开源 工 
程 导 入 到 本 地 。 根据 App 工程 提供 的 组 织 形式 ， 存 在 两 种 方法 可 以 导入 到 Android Studio。 如 
果 下 载 下 来 的 App 工程 是 Project 项 目 形式 ， 则 依次 选择 菜单 File 一 Open， 然 后 在 弹出 的 对 话 
框 中 选择 工程 目录 ， 即 可 完成 该 工程 的 导入 操作 。 如 果 下 载 下 来 的 App 工程 是 Module 模块 形 
式 ， 则 不 能 把 它 当 作 项 目 导 入 ， 和 否则 会 出 现 “Plugin with id 'com.android.application' not found.” 
的 错误 。 此 时 只 能 模块 的 形式 导入 该 App 工程 ， 具 体 的 导入 步骤 如 下 : 


(1) 依次 选择 菜单 File 一 New 一 New Project， 按 提示 新 建 一 个 项 目 〈 即 Project) 。 
(2) 项 目 创建 完毕 ， 再 依次 选择 菜单 File 一 New 一 Import Module， 然 后 在 弹出 的 对 话 框 
中 选择 模块 目录 。 
在 Android Studio 2.2/2.3/3.0 中 , 按照 上 述 步 又 能 够 正常 导入 App 模块 , 但 是 若 在 Android 


Studio 3.1 中 导入 App 模块 ， 会 发 现 AS 死活 无 法 正常 导入 。 此 时 除了 先进 行 以 上 的 两 个 导入 
步骤 之 外 ， 还 要 额外 进行 以 下 的 第 三 个 步骤 : 





局 Multisource-Drawable 
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(3) 打开 当前 项 目的 settings.gradle， 把 下 面 这 行 : 
include ':app' 
改 成 下 面 这 样 ， 也 就 是 手动 添加 新 模块 的 名 称 : 
include ":app', :新 模块 的 名 称 ' 
修改 完毕 ， 重 启 Android Studio， 再 次 打开 后 AS 就 会 自动 编译 新 模块 了 。 
1.5.5 ”新 建 一 个 Activity 页 面 
在 前 面 的 “1.4.4 在 代码 中 操纵 控件 ”中 ， 我 们 已 经 党 试 修改 XML 文件 与 Java 代码 ， 
但 这 是 在 现 有 文件 上 进行 修改 ， 如 果 要 增加 一 个 新 的 页 面 ， 就 得 先 创建 新 页 面 对 应 的 XML 布 
局 和 Java 文件 了 。 具 体 的 页 面 创建 步骤 如 下 : 
在 左 侧 工程 结构 图 中 ， 选 定 新 页 面 所 在 的 包 名 如 com.example.helloworld， 然 后 右 击 该 包 
名 ,并 在 弹出 的 右键 菜单 中 依次 选择 New 一 Activity 一 Empty Activity, 右键 菜单 如 图 1-35 所 示 。 





Link crr Project with Gradie 


Gradle Kotlin DSL Batld scripr 
Gracle Kotlin DSL Settines 
y dir Wile Tenplotes. 
| 一 serrings Act EL 
[一 mehea hetivtry [Er 





图 1-35 ”创建 Activity 页 面 的 右键 菜单 
此 时 会 弹出 新 页 面 的 创建 对 话 框 如 图 1-36 所 示 , 其 中 Activity Name 一 栏 填写 页 面 的 Java 
类 名 ，Layout Name 一 栏 填写 页 面 的 XML 布局 名 称 ，Package Name 保持 默认 的 包 名 ， 确 认 无 
误 后 单 击 窗口 右 下 方 的 Finish 按钮 。 








图 1-36 创建 Activity 页 面 的 信息 填写 窗口 
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接着 Android Studio 会 自动 在 默认 包 名 下 面 生成 页 面 代码 Main2Activity.java, 在 res\layout 
下 面 生成 页 面 布局 activity_main2.xml， 新 页 面 创建 之 后 的 工程 结构 如 图 1-37 所 示 。 


” app 
manifests 








java 
TY Bcon.exanple.hellovorld 
加 = Nain2Activity 


四 > JainActivity 
» Bcon.exranple.hellovorld (androidTest 


六 Ba con. exanple. hellovorld (test 
res 
dravwable 

Y Playout 

号 activity_nain. xnl 

强 activity_main2. ml 
» Panipnap 
» Pivalues 


1-37 新 页 面 创建 之 后 的 工程 目录 结构 


上 述 操 作 步 又 虽然 一 次 性 生成 了 Java 代码 及 其 对 应 的 XML 布局 ， 可 是 实际 开发 中 往往 
还 需要 单独 生成 Java 代码 ,或 者 单独 生成 XML 文件 。 创建 单 个 文件 的 操作 那 更 简单 了 ,倘若 
是 创建 单个 Java 代码 文件 ， 则 需 右 击 工程 目录 的 包 名 ， 在 右键 菜单 中 依次 选择 New 一 Java 
Class， 此 时 弹出 新 类 的 创建 对 话 框 如 图 1-38 所 示 。 在 该 窗口 的 Name 一 栏 填写 Java 的 类 名 ， 
在 Superclass 一 栏 填写 父 类 的 名 称 〈 如 果 有 的 话 ) ， 最 后 单 击 窗口 下 方 的 OK 按钮 ， 即 可 完成 
Java 代码 的 创建 操作 。 

倘若 是 创建 单个 XML 布局 文件 ， 则 需 右 击 layout 目录 ， 在 右键 菜单 中 依次 选择 New 一 
XML 一 Layout XML File, 此 时 弹出 XML 的 创建 对 话 框 如 图 1-39 所 示 。 在 该 窗口 的 Layout File 
Name 一 栏 填 写 布局 文件 的 名 称 ， 在 Root Tag 一 栏 填 写 XML 的 根 节点 名 称 ， 最 后 单 击 窗口 右 
下 方 的 Finish 按钮 ， 即 可 完成 XML 布局 文件 的 创建 操作 。 


er Cee 
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1-38 ”创建 Java 代码 的 对 话 框 1-39 ”创建 XML 布局 的 对 话 框 
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1.6 小 结 


本 章 主要 介绍 了 App 开发 环境 一 一 Android Studio 环境 的 搭建 。Android Studio 作为 一 个 
集成 开发 环境 ， 依 赖 于 3 个 开发 工具 : JDK、SDK、NDK。 从 创建 最 简单 的 HelloWorld 项 目 
开始 ， 依 次 介绍 了 项 目 创 建 、 项 目 编译 、 模 拟 器 创建 、 在 模拟 器 上 运行 App 这 一 连 串 开发 流 
程 。 为 了 让 读者 有 更 理性 的 认识 , 又 逐步 讲解 了 App 的 工程 目录 结构 、 编 译 配置 文件 build.gradle 
的 使 用 说 明 、App 运行 配置 文件 AndroidManifestxml 的 节点 说 明 、 如 何在 代码 中 简单 操作 控 
件 等 。 最 后 对 开发 过 程 中 的 准备 工作 做 了 必要 的 说 明 ， 主 要 包括 如 何 使 用 快捷 键 、 如 何 使 用 
SVN 进行 版 本 管理 、 如 何 安装 和 使 用 常见 插件 、 如 何 导 入 已 经 存在 的 工程 、 如 何 新 建 一 个 
Activity 页 面 。 

通过 本 章 的 学 习 ， 读 者 应 该 获得 了 Android Studio 的 基本 操作 技能 ， 能 够 使 用 自己 搭建 的 
Android Studio 环境 创建 简单 的 App 并 在 模拟 器 上 运行 ， 并 具备 进一步 提高 的 学 习 基础 。 


本 章 介 绍 Android 屏幕 显示 与 初级 视图 的 相关 知识 ， 主 要 包括 屏幕 显示 基础 、 简 单 布局 的 
用 法 、 简 单 控件 的 用 法 、 简 单 图 形 的 用 法 。 并 且 结 合 本 章 所 学 的 知识 , 演示 了 一 个 实战 项 目 “ 简 
单 计算 器 ”的 设计 与 实现 。 


2.1 屏幕 显示 


本 节 从 最 基础 的 显示 单元 开始 介绍 ， 讲 述 了 移动 设备 如 何在 屏幕 上 展现 丰富 多 彩 的 界面 。 
本 节 主 要 内 容 包 括 像素 的 几 个 常用 单位 、 颜 色 的 编码 与 使 用 、 屏 幕 分 辩 率 的 获取 等 。 


2.1.1 像素 


老子 曾 说 “天 下 难事 必 作 于 易 ， 天 下 大 事 必 作 于 细 ”，Android 开发 也 是 如 此 。 纵 使 App 
的 界面 千变万化 、 绚 丽 多 姿 ， 也 都 归 因 于 数 百 万 个 像素 的 组 合 排列 ， 就 像 万 物 缘由 原子 构成 一 
般 。 像 素 看 似 简单 ， 实 际 有 大 学 问 ， 如 果 对 像素 单位 不 知 其 所 以 然 , 开发 时 只 知 一 根 筋 的 填 数 
字 , 结果 在 模拟 器 上 运行 得 很 好 的 界面 ， 在 真 机 上 很 可 能 显示 得 东 倒 西 和 看 ， 这 就 是 没 打 好 基础 
的 缘故 。 如 果 一 开始 就 把 像素 的 基本 概念 弄 清楚 ， 后面 就 会 少 走 很 多 弯路 ， 开 发 起 来 也 会 更 加 
得 心 应 手 。 

Android 支持 的 像素 单位 有 : px (像素 ) 、in (英寸 ) 、mm (毫米 ) 、pt ( 磅 ，1/72 英寸 ) 、 
dp〔 与 设备 无 关 的 显示 单位 ) 、dip( 就 是 dp) 、sp“〈 用 于 设置 字体 大 小 ) 。 其 中 ， 常 用 的 有 
px、dp 和 sp 三 种 。 

具体 来 说 ，px 是 手机 屏幕 上 可 显示 的 最 小 单位 ， 与 物理 设备 的 显示 屏 有 关 。 一 般 来 说 ， 同 
样 尺 寸 的 屏幕 (比如 5 寸 的 手机 ) 看 起 来 越 清晰 , 像素 的 密度 越 高 ， 以 px 计量 的 分 辩 率 也 越 大 。 

dp 与 物理 设备 无 关 ， 只 与 屏幕 的 尺寸 有 关 。 一 般 来 说 ,同样 尺寸 的 屏幕 以 dp 计量 的 分 辨 
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率 是 一 样 的 ， 无 论 这 个 手机 是 哪个 厂家 生产 的 ，dp 大 小 都 一 样 。 

sp 的 原理 跟 dp 差不多 ， 专 门 用 于 设置 字体 大 小 。 手 机 在 系统 设置 里 可 以 调整 字体 的 大 小 
(小 、 普 通 、 大 、 超 大 ) 。 设 置 普 通 字体 时 ， 同 数值 dp 和 sp 的 文字 看 起 来 一 样 大 ;如 果 设 置 
为 大 字体 ， 用 dp 设置 的 文字 没有 变化 , 用 sp 设置 的 文字 就 变 大 了 。 例 如 ， 当 系统 设置 普通 字 
体 时 ，18dp 与 18sp 的 文字 一 样 大 ， 如 图 2-1 所 示 ; 当 系 统 设置 大 字体 时 ，18dp 的 文字 大 小 不 
变 ，18sp 的 文字 却 增 大 了 ， 如 图 2-2 所 示 。 











Hello World! Hello World! 
Hello World! Hello World! 
图 2-1 普通 字体 的 效果 图 图 2-2 大 字体 的 效果 图 


所 以 说 ，dp 与 系统 设置 的 字体 大 小 没有 关系 ， 而 sp 会 随 系统 设置 的 字体 大 小 变 大 或 变 小 。 
dp 和 px 之 间 的 联系 取决 于 具体 设备 上 的 像素 密度 ， 像 素 密度 就 是 DisplayMetrics 里 的 
density 参数 。 当 density=1.0 时 ， 表 示 一 个 dp 值 对 应 一 个 px 值 ; 当 density=1.5 时 ， 表 示 两 个 
dp 值 对 应 3 个 px 值 ; 当 density=2.0 时 , 表示 一 个 dp 值 对 应 两 个 px 值 。 具 体 的 转换 函数 如 下 : 
/ 根据 手机 的 分 辩 率 从 dp 的 单位 转 成 为 px( 像 素 ) 
public static int dip2px(Context context, float dpValue) { 
/ 获取 当前 手机 的 像素 密度 
final float scale = context.getResources().getDisplayMetrics0.density; 
return (int) (dpValue * scale + 0.5$0; / 四 使 五 入 取 整 
} 
/ 根据 手机 的 分 辩 率 从 px( 像 素 ) 的 单位 转 成 为 dp 
public static int px2dip(Context context, float pxValue) { 
/ 获取 当前 手机 的 像素 密度 
final float scale = context.getResources().getDisplayMetrics().density; 
return (int) (pxValue / scale + 0.5f); // 四 舍 五 入 取 整 
} 
在 XML 布局 文件 中 ， 为 了 让 不 同 设备 屏幕 拥有 统一 的 显示 效果 ， 除 了 sp 用 于 设置 文字 
大 小 外 ， 其 余 要 用 尺寸 大 小 的 地 方 都 用 dp。 在 代码 中 情况 又 有 所 不 同 ，Android 用 于 设置 大 小 
的 函数 都 以 px 为 单位 。 无 论 是 LayoutParams 里 的 width 和 height, 还 是 setMargins 和 setPadding， 
参数 单位 都 是 px， 要 想 在 代码 中 使 用 dp 设置 布局 大 小 或 间距 ， 得 先 把 dp 值 转换 成 px 值 。 代 
码 示例 如 下 : 


/ 将 10dp 的 尺寸 大 小 转换 为 对 应 的 px 数值 

int dip_10= Utils.dip2px(this, 10L); 

/ 从 布局 文件 中 获取 名 叫 tv_padding 的 文本 视图 
TextView tv_padding = findViewById(R.id.tv_padding); 
/ 设置 该 文本 视图 的 内 部 文字 与 控件 四 周 的 间隔 大 小 
tv_padding.setPadding(dip_10, dip_10, dip_10, dip_10): 
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2.1.2 ”颜色 


在 Android 中 ， 颜 色 值 由 透明 度 alpha 和 RGB ( 红 、 绿 、 蓝 ) 三 原色 定义 ， 有 八 位 十 六 进 
制 数 与 六 位 十 六 进 制 数 两 种 编码 ， 例 如 八 位 编码 FFEEDDCC，FF 表示 透明 度 ，EE 表示 红色 
的 浓度 ，DD 表示 绿色 的 浓度 ，CC 表示 蓝 色 的 浓度 。 透 明度 为 FF 表示 完全 不 透明 ， 为 00 表 
示 完 全 透明 。RGB 三 色 的 数值 越 大 颜色 越 浓 也 就 越 亮 ， 数 值 越 小 颜色 越 暗 。 亮 到 极致 就 是 白 
色 ， 暗 到 极致 就 是 黑色 ， 这 样 记 就 不 会 摘 混 了 。 

六 位 十 六 进 制 编码 有 两 种 情况 ， 在 XML 文件 中 默认 不 透明 〈 透 明度 为 FF) ， 在 代码 中 默 
认 透 明 〈 透 明度 为 00) 。 下 面 的 代码 分 别 给 两 个 文本 控件 设置 六 位 编码 和 八 位 编码 的 背景 色 。 

/ 从 布局 文件 中 获取 名 叫 tv_code six 的 文本 视图 

TextView tv_code six = findViewById(R.id.tv_code six); 

// 给 文本 视图 tv_code six 设置 背景 为 透明 的 绿色 ， 透 明 就 是 看 不 到 

tv_code six.setBackgroundColor(0x00fP00); 

/ 从 布局 文件 中 获取 名 叫 tv_code eight 的 文本 视图 

TextView tv_code eight = findViewById(R.id.tv_code_ eight); 

// 给 文本 视图 tv_code_eight 设置 背景 为 不 透明 的 绿色 ， 即 正常 的 绿色 

tv_code_eightsetBackgroundColor(Oxffr00fP00); 


从 图 2-3 可 以 看 到 ， 代 码 使 用 六 位 编码 看 不 到 任何 背景 ， 使 用 八 位 编码 能 够 看 到 正确 的 绿 
色 背 景 。 
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2-3 不 同方 式 设置 颜色 编码 的 效果 图 
在 Android 中 使 用 颜色 有 下 列 3 种 方式 : 
1. 使 用 系统 已 定义 的 颜色 常量 。 
Android 系统 有 12 种 已 经 定义 好 的 颜色 , 具体 的 类 型 定义 在 Color 类 中 , 详细 的 取 值 说 明 
见 表 2-1。 
表 2-1 颜色 类 型 的 取 值 说 明 


Color 类 中 的 颜色 类 型 Color 类 中 的 颜色 类 型 



























BLACK 黑 GREEN 绿色 
DKGRAY 深 灰 BLUE | 蓝 色 
GRAY 灰色 YELLOW | 黄色 
LTGRAY 浅 灰 CYAN | 青色 
WHITE MAGENTA | 政 红 





RED TRANSPARENT 
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2. 使 用 十 六 进 制 的 颜色 编码 。 


在 布 





局 文件 中 设置 颜色 需要 在 色 值 前 面 加 “#”， 如 android:textColor="#000000"。 在 代码 





中 设置 颜色 可 以 直接 填 八 位 的 十 六 进 制 数值 (如 setTextColor(0xff00ff00);，》， 也 可 以 通过 
Color.rgb(int red, int green, int blue) 和 Color.argb(int alpha, int red, int green, int blue) 这 两 种 方法 
指定 颜色 。 在 代码 中 一 般 不 要 用 六 位 编码 ， 因 为 六 位 编码 在 代码 中 默认 透明 , 所 以 代码 用 六 位 
编码 跟 不 用 没什么 区 别 。 

3. 使 用 colors.xml 中 定义 的 颜色 。 


res/values 目录 下 有 个 colors.xml 文件 ， 是 颜色 常量 的 定义 文件 。 如 果 要 在 布局 文件 中 使 
用 XML 颜色 常量 ， 可 引用 “@color/ 常 量 名 ”; 如 果 要 在 代码 中 使 用 XML 颜色 常量 ， 可 通过 
这 行 代码 获取 :，getResources().getColor(R.color. 常 量 名 )。 


2.1.3 ”屏幕 分 辩 率 


在 App 编码 中 时 常 要 取 手 机 的 屏幕 分 辩 率 〈 如 当前 屏幕 的 宽 和 高 ) ， 然 后 动态 调整 界面 
上 的 布局 。 在 代码 中 获取 分 辩 率 就 是 想 办 法 获得 DisplayMetrics 对 象 ， 然 后 从 该 对 象 中 获得 宽 
度 、 高 度 、 像 素 密度 等 信息 。 下 面 是 DisplayMetrics 类 的 常用 属性 说 明 。 

@ widthPixels: 以 px 为 单位 计量 的 宽度 值 。 

e@ heightPixels: 以 px 为 单位 计量 的 高 度 值 。 

e@ density: 像素 密度 ， 即 一 个 dp 单位 包含 多 少 个 px 单位 。 


下 面 是 获取 当前 屏幕 的 宽度 、 高 度 、 像 素 密度 的 代码 示例 。 


/ 获得 屏幕 的 宽度 
public static int getScreenWidth(Context ctx) { 


/ 从 系统 服务 中 获取 窗口 管理 器 

WindowManager wm = (WindowManager) ctx.getSystemService(Context WINDOW_SERVICE); 
DisplayMetrics dm = new DisplayMetrics(); 

/ 从 默认 显示 器 中 获取 显示 参数 保存 到 dm 对 象 中 

wm.getDefaultDisplay().getMetrics(dm); 

Teturn dm.widthPixels; / 返回 屏幕 的 宽度 数值 


/ 获得 屏幕 的 高 度 
public static int getScreenHeight(Context ctx) { 


/ 从 系统 服务 中 获取 窗口 管理 器 

WindowManager wm = (WindowManager) ctx.getSystemService(Context WINDOW_SERVICE); 
DisplayMetrics dm = new DisplayMetrics(); 

// 从 默认 显示 器 中 获取 显示 参数 保存 到 dm 对 象 中 

wm.getDefaultDisplay().get Metrics(dm); 

return dm.heightPixels; / 返回 屏幕 的 高 度数 值 
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/ 获得 屏幕 的 像素 密度 
public static float getScreenDensity(Context ctx) { 
/ 从 系统 服务 中 获取 窗口 管理 器 
WindowManager wm = (WindowManager) ctx.getSystemService(Context.WINDOW _SERVICE); 
DisplayMetrics dm = new DisplayMetrics(); 
/ 从 默认 显示 器 中 获取 显示 参数 保存 到 dm 对 象 中 
wm.getDefaultDisplay().get Metrics(dm); 
Teturn dm.density; / 返回 屏幕 的 像素 密度 数值 
} 


从 一 个 接 入 设备 上 获得 屏幕 分 辨 率 信 息 ， 如 图 2-4 所 示 。 该 设备 为 5 寸 屏 幕 ， 分 辩 率 是 
720*1280， 像 素 密度 是 2。 
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当前 屏幕 的 宽度 是 720px， 高 度 
是 1280px， 像 素 密度 是 2.000000 





图 24 某 手机 上 的 分 辩 率 信息 


2.2 简单 布局 


本 节 开 始 介绍 Android 的 基本 视图 和 布局 , 首先 说 明基 本 视图 View 类 的 常用 属性 和 方法 ， 
接着 描述 如 何 使 用 线性 布局 LinearLayout， 最 后 介绍 滚动 视图 ScrollView 的 用 法 。 


2.2.1 视图 View 的 基本 属性 


View 是 Android 的 基本 视图 , 所 有 控件 和 布局 都 是 由 View 类 直接 或 间接 派生 而 来 的 。 故 
而 View 类 的 基本 属性 和 方法 是 各 控件 和 布局 通用 的 ， 掌 握 好 基本 属性 和 方法 ， 在 哪里 都 能 
上 用 场 ， 能 够 举一反三 、 事 半 功 倍 。 

下 面 是 视图 在 XML 布局 文件 中 常用 的 属性 定义 说 明 。 


e id: 指定 该 视图 的 编号 。 

elayout width: 指定 该 视图 的 宽度 。 可 以 是 具体 的 dp 数值 ; 可 以 是 match_parent， 表 示 与 
上 级 视图 一 样 宽 ; 也 可 以 是 wrap_content， 表 示 与 内 部 内 容 一 样 宽 ( 内 部 内 容 若 超过 上 级 
视图 的 宽度 ， 则 该 视图 保持 与 上 级 视图 一 样 帘 ， 超 出 宽度 的 内 容 得 进行 滚动 才能 显示 出 
来 )。 

e layout height: 指定 该 视图 的 高 度 。 取 值 说 明 同 layout_width。 

e@ layout_margin: 指定 该 视图 与 周围 视图 之 间 的 空白 距离 (包括 上 、 下 、 左 、 右 ) 。 另 
有 layout marginTop、layout_marginBottom、layout_marginLeft 、layout_marginRight 


分 别 表示 单独 指定 视图 与 上 边 、 下 边 、 左 边 、 右 边 视 图 的 距离 。 
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minWidth: 指定 该 视图 的 最 小 宽度 。 

















二 
e minHeight: 指定 该 视图 的 最 小 高 度 。 
e@ background: 指定 该 视图 的 背景 。 背 景 可 以 是 颜色 ， 也 可 以 是 图 片 。 
elayout_gravity: 指定 该 视图 与 上 级 视图 的 对 齐 方式 。 对 齐 方式 的 取 值 说 明 见 表 2-2， 若 
同时 适用 多 种 对 齐 方式 ， 则 可 使 用 竖 线 “|” 把 多 种 对 齐 方式 拼接 起 来 。 
表 2-2 对齐 方式 的 取 值 说 明 
XML 中 的 对 齐 方式 Gravity 类 中 的 对 齐 方 式 说 明 
left LEFT 靠 左 对 齐 
right RIGHT 靠 右 对 齐 
top TOP 向 上 对 齐 
bottom BOTTOM 向 下 对 齐 
center CENTER 居中 对 齐 
center_horizontal CENTER HORIZONTAL 水 平方 向 居中 
center_vertical CENTER VERTICAL 垂直 方向 居中 








e@ padding: 指定 该 视图 边缘 与 内 部 内 容 之 间 的 空白 距离 。 另 有 paddingTop 、 
paddingBottom、paddingLeft、paddingRight 分 别 表示 指定 视图 边缘 与 内 容 上 边 、 下 边 、 
左边 、 右 边 的 距离 。 

e visibility: 指定 该 视图 的 可 视 类 型 。 可 视 类 型 的 取 值 说 明 见 表 2-3。 


表 2-3 可 视 类 型 的 取 值 说 明 





XML 中 的 可 视 类 型 View 类 中 的 可 视 类 型 
visible VISIBLE 

invisible INVISIBLE 

gone GONE 


说 明 
可 见 。 默 认 值 

不 可 见 。 虽 然 看 不 到 但 还 占 着 位 置 
消失 。 不 仅 看 不 到 而 且 不 占 位 置 了 


























下 面 是 视图 在 代码 中 常用 的 设置 方法 说 明 。 


e setLayoutParams: 设置 该 视图 的 布局 参数 。 参 数 对 象 的 构造 函数 可 以 设置 视图 的 宽度 
和 高 度 。 其 中 ，LayoutParams.MATCH_PARENT 表示 与 上 级 视图 一 样 宽 ， 也 可 以 是 
LayoutParams.WRAP_CONTENT， 表 示 与 内 部 内 容 一 样 宽 ; 参数 对 象 的 setMargins 方 
法 可 以 设置 该 视图 与 周围 视图 之 问 的 空白 距离 。 

setMinimumWidth: 设置 该 视图 的 最 小 宽度 。 

setMinimumHeight: 设置 该 视图 的 最 小 高 度 。 

setBackgroundColor: 设置 该 视图 的 背景 颜色 。 

setBackgroundDrawable: 设置 该 视图 的 背景 图 片 。 

setBackgroundResource: 设置 该 视图 的 背景 资源 id。 

setPadding: 设置 该 视图 边缘 与 内 部 内 容 之 间 的 空白 距离 。 

setVisibility: 设置 该 视图 的 可 视 类 型 。 取 值 说 明 见 表 2-3。 


前 面 提 到 margin 和 padding 两 个 概念 ，margin 是 指 当 前 视图 与 周围 视图 的 距离 ，padding 
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是 指 当前 视图 与 内 部 内 容 的 距离 。 这 么 说 可 能 有 些 抽象 ， 所 谓 百 闻 不 如 一 见 , 说 得 再 多 不 如 亲 
眼看 看 是 怎么 回 事 。 接 下 来 做 一 个 实验 , 看 看 它们 的 显示 效果 有 什么 不 同 。 下 面 是 实验 用 的 布 








局 文件 源 代码 ， 以 背景 色 观 察 每 个 控件 的 区 域 范围 : 
<!-- 最 外 层 的 布局 背景 为 蓝 色 -> 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout_ width="match parent" 
android:layout_height="300dp" 
android:background="#00aaff” 
android:orientation= "vertical" 
android:padding="5dp"> 


<!-- 中 间 层 的 布局 背景 为 黄色 --> 

<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_margin="20dp" 
android:background="#fIFR99" 
android:padding="60dp"> 


<!-- 最 内 层 的 视图 背景 为 红色 一 > 
<View 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="#ff0000" /> 
</LinearLayout> 
</LinearLayout> 


最 后 的 界面 效果 如 图 2-5 所 示 。 布 局 文件 处 于 中 
间 层 的 LinearLayout， 设 置 margin 是 20dp、padding 
是 60dp。 从 效果 图 可 以 看 到 ， 中 间 层 与 上 级 视图 之 间 
的 距离 大 约 是 中 间 层 与 下 级 视图 之 间距 离 的 三 分 之 
-， 正 好 是 margin 和 padding 两 个 数值 的 比例 。 如 此 
便 从 实际 情况 中 印证 了 : layout_margin 指 的 是 当前 图 
层 与 外 部 图 层 的 距离 ， 而 padding 指 的 是 当前 图 层 与 
内 部 图 层 的 距离 。 
视图 组 ViewGroup 是 一 类 特殊 视图 ， 所 有 的 布局 
类 视图 都 是 从 它 派生 而 来 的 ,Android 中 的 视图 分 为 两 
类 ， 一 类 是 布局 ， 另 一 类 是 控件 。 布 局 与 控件 的 区 别 
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图 2-5 margin 和 padding 的 演示 画面 


在 于 : 布局 本 质 上 是 个 容器 ， 里面 还 可 以 放 其 他 视图 (包括 子 布局 和 子 控件 ) ; 控件 是 一 个 单 


-的 实体 ， 己 经 是 最 后 一 级 ， 下 面 不 能 再 挂 其 他 视图 。 打 个 比方 ,如果 把 根 节点 看 作 树干 ， 根 
节点 下 的 各 级 布局 就 是 树枝 , 一 根 树枝 可 以 连 着 其 他 小 树枝 , 也 可 以 直接 连 树叶 ; 树叶 只 能 依 
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附 在 树枝 上 ， 不 能 再 连 树枝 或 其 他 树叶 。 
ViewGroup 有 3 个 方法 ， 这 3 个 方法 也 是 所 有 布局 类 视图 共同 拥有 的 。 


e@ addView: 往 布局 中 添加 一 个 视图 。 
e。 removeView: 从 布局 中 删除 指定 视图 。 
e@ removeAllViews: 删除 该 布局 下 的 所 有 视图 。 


2.2.2 ”线性 布局 LinearLayout 


LinearLayout 是 最 常用 的 布局 ， 名 字 叫 线性 布局 。 顾 名 思 义 ，LinearLayout 下 面 的 子 视图 
就 像 用 一 根 线 串 了 起 来 , 所 以 LinearLayout 内 部 视图 的 排列 是 有 顺序 的 , 要 么 从 上 到 下 依次 垂 
直 排列 ， 要 么 从 左 到 右 依 次 水 平 排列 。LinearLayout 除了 继承 View/ViewGroup 类 的 所 有 属性 
和 方法 外 ， 还 有 其 特有 的 XML 属性 ， 说 明 如 下 。 


e@ orientation: 指定 线性 布局 的 方向 。horizontal 表示 水 平 布局 ，vertical 表示 垂直 布局 。 
如 果 不 指定 该 属性 ， 就 默认 是 horizontal。 这 真是 出 乎 意料 ， 因 为 大 家 感觉 手机 App 
理应 从 上 往 下 垂直 布局 ， 所 以 这 里 要 特别 注意 垂直 布局 一 定 要 设置 orientation， 不 然 
默认 的 水 平 布局 不 符合 多 数 业务 场景 。 

e gravity: 指定 布局 内 部 视图 与 本 线性 布局 的 对 齐 方式 。 取 值 说 明 同 layout_gravity。 

e layout_ weight: 指定 当前 视图 的 宽 或 高 占 上 级 线性 布局 的 权重 。 这 里 要 注意 ， 
layout_weight 属性 并 非 在 当前 LinearLayout 节点 中 设置 ,而 是 在 下 级 视图 的 节点 中 设置 。 
另外 ， 如 果 layout_weight 指定 的 是 当前 视图 在 宽度 上 占 的 权重 ，layout_width 就 要 同时 
设置 为 0dp; 如 果 layout_weight 指定 的 是 当前 视图 在 高 度 上 占 的 权重 ，layout_height 就 
要 同时 设置 为 0dp。 


下 面 是 LinearLayout 在 代码 中 增加 的 两 个 方法 。 


e@ setOrientation: 设置 线性 布局 的 方向 。LinearLayout.HORIZONTAL 表示 水 平 布局 ， 
LinearLayout.VERTICAL 表示 垂直 布局 。 
e setGravity: 设置 布局 内 部 视图 与 本 线性 布局 的 对 齐 方式 。 具 体 的 取 值 说 明 见 表 2-2。 


接 下 来 重点 解释 layout_gravity 和 gravity 的 区 别 。 前 面 说 过 ，layout_gravity 指定 该 视图 与 
上 级 视图 的 对 齐 方式 ， 而 gravity 指定 布局 内 部 视图 与 本 布局 的 对 齐 方式 。 为 方便 理解 ， 下 面 
通过 一 个 具体 例子 演示 两 种 属性 的 显示 效果 。 下 面 是 演示 用 的 XML 布局 文件 ， 内 部 指定 了 多 
种 对 齐 方式 , 其 中 左边 视图 的 1ayout_gravity 是 bottom、gravity 是 left; 右边 视图 的 layout_gravity 
是 top、gravity 是 right， 布 局 文件 内 容 如 下 : 
<!-- 最 外 层 的 布局 背景 为 橙色 ， 它 的 下 级 布局 在 水 平方 向 上 依次 排列 -> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="300dp" 
android:background="#ffff99" 
android:orientation="horizontal" 
android:padding="Sdp"> 
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<!-- 第 一 个 子 布局 背景 为 红色 ， 它 与 上 级 布局 靠 下 对 齐 ， 它 的 下 级 视图 则 靠 左 对 齐 --> 

<LinearLayout 
android:layout_width="0dp" 
android:layout_height="200dp" 
android:layout_ weight="1" 
android:layout_gravity="bottom" 
android:gravity="left" 
android:background="#ff0000" 
android:layout_margin="10dp" 
android:padding="10dp" 
android:orientation="vertical"> 


<!- 内 层 视 图 的 宽度 和 高 度 都 是 100dp， 且 背景 色 为 青色 -> 
<View 
android:layout_width="100dp" 
android:layout_height="100dp" 
android:background="#00ffFf" /> 
</LinearLayout> 


<!-- 第 二 个 子 布局 背景 为 红色 ， 它 与 上 级 布局 靠 上 对 齐 ， 它 的 下 级 视图 则 靠 右 对 齐 --> 

<LinearLayout 
android:layout_width="0dp" 
android:layout_height="200dp" 
android:layout_weight="1" 
android:layout_gravity="top" 
android:gravity="right" 
android:background="#ff0000" 
android:layout_margin="10dp” 
android:padding="10dp" 
android:orientation="vertical"> 


<!-- 内 层 视 图 的 宽度 和 高 度 都 是 100dp， 且 背景 色 为 青色 -> 
<View 
android:layout_width="100dp" 
android:layout_height="100dp" 
android:background="#OOffPF' 这 
</LinearLayout> 
</LinearLayout> 


运行 后 的 界面 效果 如 图 2-6 所 示 。 从 效果 图 可 以 看 到 ， 左 边 视图 自身 向 下 对 齐 ， 符 合 
layout_gravity 的 设置 ， 下 级 视图 靠 左 对 齐 ， 符 合 gravity 的 设置 ;右边 视图 自身 向 上 对 齐 ， 符 
合 layout_gravity 的 设置 ， 下 级 视图 靠 右 对 齐 ， 符 合 gravity 的 设置 。 
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2-6 layout_gravity 和 gravity 的 演示 界面 
2.2.3 滚动 视图 ScrollView 


手机 屏幕 的 显示 空间 有 限 ， 常 常 需要 上 下 滑动 或 左右 滑动 才能 拉 出 其 余 页 面 内 容 ， 可 惜 
Android 的 布局 节点 都 不 支持 自行 滚动 ， 这 时 就 要 借助 ScrollView 滚动 视图 实现 了 。 与 线性 布 
局 类 似 ， 滚 动 视 图 也 分 为 垂直 方向 和 水 平方 向 两 类 ， 其 中 垂直 滚动 的 视图 名 是 ScrollView, 水 
平 滚动 的 视图 名 是 HorizontalScrollView。 这 两 个 滚动 视图 的 使 用 并 不 复杂 ， 主 要 注意 以 下 3 点 : 


(1) 垂直 方向 滚动 时 ，layout_ width 要 设置 为 match_parent，layout_height 要 设置 为 
wrap_content。 

(2) 水 平方 向 滚动 时 ，layout_width 要 设置 为 wrap_content，layout_height 要 设置 为 
match_parent。 

(3) 滚 动 视图 节点 下 面 必 须 上 且 只 能 挂 着 一 个 子 布 局 节点 , 否则 会 在 运行 时 报错 Caused by: 


java.lang.IllegalStateException: ScrollView can host only one direct child 。 
下 面 是 滚动 视图 ScrollView 和 水 平 滚动 视图 HorizontalScrollView 的 XML 用 法 示例 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical"> 


<!-- HorizontalScrollView 是 水 平方 向 的 滚动 视图 ， 当 前 高 度 为 200dp --> 
<HorizontalScrollView 
android:layout_width="wrap_content" 
android:layout_height="200dp"> 


<!-- 水 平方 向 的 线性 视图 ， 两 个 子 视图 的 颜色 分 别 为 青色 和 黄色 --> 
<LinearLayout 
android:layout_width="wrap_content" 
android:layout_height="match_parent" 
android:orientation="horizontal"> 
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<View 
android:layout_width="400dp" 
android:layout_height="match_parent" 
android:background="#aaffff' /> 


<View 
android:layout_width="400dp" 
android:layout_height="match_parent" 
android:background="#ffff00" /> 
</LinearLayout> 
</HorizontalScrollView> 


<!-- ScrollView 是 垂直 方向 的 滚动 视图 ， 当 前 高 度 为 自 适 应 --> 
<ScrollView 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<!-- 垂直 方向 的 线性 视图 ， 两 个 子 视 图 的 颜色 分 别 为 绿色 和 橙色 --> 
<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:orientation="vertical"> 


<View 
android:layout_width="match_parent" 
android:layout_height="400dp" 
android:background="#00ff00" /> 


<View 
android:layout_ width="match_parent" 
android:layout_height="400dp" 
android:background="#ffffaa" /> 
</LinearLayout> 
</ScrollView> 
</LinearLayout> 


有 时 ScrollView 的 实际 内 容 不 够 ， 又 想 让 它 充 满 屏幕 ， 怎 么 办 呢 ? 如 果 把 layout_height 属 
性 赋值 为 match_parent， 那 么 结果 还 是 不 会 充满 ， 正 确 的 做 法 是 再 增加 一 行 但 IViewport 的 属 


性 设置 (该 属性 为 true 表示 允许 填 满 视图 窗口 ) ， 举 例如 下 : 


android:layout_height="match_parent" 
android:fillViewport="true" 
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2.3 简单 控件 


本 节 介 绍 Android 几 个 简单 控件 的 用 法 与 注意 点 ， 主 要 包括 文本 视图 TextView 的 跑马 灯 
与 聊天 室 效 果 、 按 钮 Button 的 监听 器 使 用 、 图 像 视图 ImageView 的 拉 伸 效果 与 截图 功能 、 图 
像 按钮 ImageButton 的 适用 场合 等 。 


2.3.1 文本 视图 TextView 





TextView 是 最 基础 的 文本 显示 控件 ， 常 用 的 基本 属性 和 设置 方法 见 表 2-4。 


表 2-4 TextView 的 基本 属性 和 设置 方法 说 明 
XML 中 的 属性 | TextView 类 的 设置 方法 | 说 明 


text 设置 文本 内 容 
textColor 设置 文本 颜色 
si 文本 


textAppearance 设置 文本 风格 ， 风 格 定义 在 res/styles.xml 


gravity 设置 文本 的 对 齐 方式 ， 对 应 的 方法 是 setGravity。 取 值 说 明 见 
表 2-2 


读者 对 于 这 些 基 本 属性 和 方法 想必 并 不 陌生 ， 因 为 在 第 1 章 第 一 个 App“Hello World” 
中 就 用 到 了 它们 ， 这 里 不 再 獒 述 。 接 下 来 介绍 TextView 的 两 个 特效 用 法 。 


1. 跑马 灯 效 果 


当 一 行文 本 的 内 容 太 多 ， 导 致 无 法 全 部 显示 ， 也 不 想 分 行 展示 时 ， 只 能 让 文字 从 左 向 右 
滚动 显示 , 类 似 于 跑马 灯 。 电视 在 播报 突 发 新 闻 时 经 常 在 屏幕 下 方 轮 播 消息 文字 ， 比 如 “快讯 : 
我 国 选手 *** 在 刚刚 结束 的 ** 比 赛 中 为 中 国 代表 团 夺 得 第 ** 枚 金牌 ”。 
跑马 灯 效 果 在 XML 布局 文件 中 实现 时 需要 额外 指定 部 分 属性 , 这 些 特 殊 属 性 及 其 设置 方 
法 的 详细 说 明 见 表 2-5。 

















表 2-5 ”跑马 灯 用 到 的 属性 与 方法 说 明 






























XML 中 的 属性 跑马 灯 用 到 的 设置 方法 | 说 明 

singleLine setSingleLine 指定 文本 是 否 单行 显示 

ellipsize setEllipsize 指定 文本 超出 范围 后 的 省 略 方式 ， 省 略 方式 的 取 值 说 
明 见 表 2-6 

focusable | setFocusable 指定 是 否 获得 焦点 ， 跑 马 灯 效 果 要 求 设置 为 true 

focusableInTouchMode | setFocusableInTouchMode | 指定 在 触摸 时 是 否 获 得 焦点 ， 跑 马 灯 效 果 要 求 设置 为 


true 
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表 2-6 省 略 方式 的 取 值 说 明 














XML 中 的 省 略 方式 TruncateAt 类 中 省 略 方式 说 明 

Start START 省 略 号 在 开头 
middle MIDDLE 省 略 号 在 中 间 
end END 省 略 号 在 末尾 
marquee MARQUEE 跑马 灯 显 示 





下 面 是 演示 跑马 灯 效 果 的 XML 布 








局 文件 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 


android:layout_height="match_parent" 


android:orientation="vertical"> 


<!-- 这 个 是 普通 的 文本 视图 -> 
<TextView 


android:layout_width="match_parent" 


android:layout_height="wrap_content" 


android:layout_marginTop="20dp" 


android:gravity="center" 


android:text=" 跑 马 灯 效果 ， 点 击 暂 停 ， 再 点 击 恢复 " /> 


<!-- 这 个 是 跑马 灯 滚 动 的 文本 视图 ，ellipsize 属性 设置 为 true 表示 文字 从 右 向 左 滚动 -> 


<TextView 
android:id="@+id/tv_marquee" 


android:layout_width="match_parent" 


android:layout_height="wrap_content" 


android:layout_marginTop="20dp" 


android:singleLine="true" 
android:ellipsize="marquee" 
android:focusable="true" 


android:focusableInTouchMode="true" 


android:textColor="#000000" 
android:textSize="17sp" 


android:text=" 快 讯 : 红色 预警 ， 超 强 台 风 “ 莫 兰 蒂 ” 即 将 登陆 ， 请 居民 关 紧 门窗 、 备 足 粮草 ， 


做 好 防汛 救灾 准备 !" /> 
</LinearLayout> 


跑马 灯 滚动 的 效果 界面 如 图 2-7 和 图 2-8 所 示 。 左 图 为 跑马 灯 文 字 在 滚动 中 ， 右 图 为 跑马 


灯 文 字 停止 滚动 。 
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, 超 强 台风 "“ 莫 兰 带 "即将 登陆 ， 请 居民 关 紧 门窗 、 备 足 粮 讯 : 红色 预警 ， 超 强 台风 * 莫 兰 蒂 "即将 登陆 ， 请 居民 关 





图 2-7 跑马 灯 文 字 滚 动 界面 图 2-8 跑马 灯 文 字 停止 滚动 界面 
2. 聊天 室 或 者 文字 直播 间 效果 


聊天 室 窗 口 的 高 度 是 固定 的 ， 新 的 文字 消息 总 是 加 入 窗口 末尾 ， 同 时 窗口 内 部 的 文本 整 
体 向 上 滚动 ， 窗 口 的 大 小 、 位 置 保持 不 变 。 

在 XML 布局 文件 中 实现 聊天 室 时 需要 额外 指定 部 分 属性 , 这 些 特殊 属性 及 其 设置 方法 的 
详细 说 明 见 表 2-7。 


表 12-7 聊天 室 用 到 的 属性 与 方法 说 阴 





XML 中 的 属性 | 聊天 室 用 到 的 设置 方法 | 说 明 

gravity setGravity 指定 文本 的 对 齐 方式 ， 取 值 leftlbottom， 表 示 靠 左 对 齐 且 靠 下 
对 齐 

lines setLines 指定 文本 的 行 数 

maxLines setMaxLines 指定 文本 的 最 大 行 数 

scrollbars 无 指定 滚动 条 的 方向 , 取 值 vertical, 如 果 不 指定 将 不 显示 滚动 条 

无 setMovementMethod 设置 文本 的 移动 方式 , 可 设置 ScrollingMovementMethod， 如 果 
不 设置 将 无 法 拉动 文本 








接 下 来 看 一 个 简单 聊天 室 的 例子 ， 点 击 聊天 室 窗口 可 以 添加 一 条 聊天 记录 ， 长 按 聊 天 窗 
口 可 以 清除 所 有 聊天 记录 。 聊 天 室 的 演示 界面 如 图 2-9 和 图 2-10 所 示 ， 图 2-10 比 图 2-9 多 添 
加 了 3 条 聊天 记录 ， 整 个 聊天 记录 的 文字 自动 往 上 滚动 。 





聊天 室 效果， 点 击 灌 加 聊天 记录 ， 长 控制 除 聊天 记录 聊天 室 效果 ,点击 尖 加 聊天 记录 ， 长 按 短 除 聊天 记录 


3:10:11 你 吃饭 了 吗 ? 3:10:17 我 中 奖 啦 ! 


3:10:24 我 们 去 看 电影 吧 
3:10:27 晚上 干什么 好 呢 ? 3:11:34 我 们 去 看 电影 吧 








图 2-9 初始 的 聊天 室 界面 图 2-10 增加 了 3 条 聊天 记录 
下 面 是 聊天 室 例子 用 到 的 XML 布局 文件 内 容 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical"> 
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<!-- 这 是 普通 的 文本 视图 -> 


<TextView 


android:id="(@+id/tv_control" 
android:layout_width="match_parent" 


android:layout_height="wrap_content" 


android:layout_marginTop="20dp" 
android:gravity="center" 
android:text=" 聊 天 室 效果 ， 点 击 添加 聊天 记录 ， 长 按 删 除 聊天 记录 " /> 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="200dp" 
android:orientation="vertical"> 


<!-- 这 是 聊天 室 的 文本 视图 ， scrollbars 属性 设置 为 vertical 表示 在 垂直 方向 上 显示 滚动 条 --> 
<TextView 


android:id="(@+id/tv_bbs" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_marginTop="20dp" 
android:gravity="leftlbottom" 
android:lines="8" 
android:maxLines="8" 
android:scrollbars="vertical” 
android:textColor="#000000" 
android:textSize="17sp" 亡 


</LinearLayout> 
</LinearLayout> 


本 书 附 带 源码 提供 了 所 有 例子 的 完整 布局 和 代码 ， 其 中 聊天 室 部 分 详 见 junior 模块 的 
activity_bbs.xml 和 BbsActivity.java。 
2.3.2 按钮 Button 


Button 派 和 





E 自 TextView， 二 者 在 UI 上 的 区 别 主要 是 Button 控件 有 个 按钮 外 观 ， 提 示 用 


户 点 击 这 里 。 系统 默 认 的 按钮 外 观 通常 都 不 好 看 ,需要 更 换 靓 一 点 、 活泼 一 点 的 图 片 ， 这 时 在 
布局 文件 中 修改 Button 节点 的 background 属性 就 可 以 了 。 如 果 把 background 属性 设置 为 @null， 
就 会 去 除 Button 控件 的 背景 样式 ， 此 时 的 Button 看 起 来 跟 TextView 没什么 区 别 。 

前 面 在 演示 聊天 室 功 能 时 ， 页 面 代码 给 TextView 引入 了 点 击 方法 和 长 按 方法 。 因 为 点 击 
和 长 按 监听 器 都 来 源 于 View 类 , 所 以 这 两 个 方法 及 其 监听 器 并 非 Button 特有 的 , 而 是 所 有 布 
局 和 控件 都 能 使 用 的 ， 一 般 用 于 为 按钮 控件 注册 点 击 和 长 按 事件 。 


Android 中 








的 简单 按钮 主要 是 Button 和 后 面 提 到 的 ImageButton。 这 两 个 按钮 对 点 击 和 长 
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按 监听 器 的 使 用 方法 并 不 复杂 ， 主 要 步骤 如 下 : 





CT 自己 定义 一 个 扩展 自 监听 器 的 类 ， 如 点 击 监听 器 扩展 自 View.OnClickListener， 长 按 
监听 器 扩展 自 View.OnLongClickListener。 为 了 方便 起 见 ， 也 可 以 直接 给 页 面 的 Activity 类 加 上 监听 





器 接口 。 
GT02 在 自 定义 监听 器 类 中 重 写 点 击 或 者 长 按 方 法 ， 加 入 事件 处 理 的 代码 。 点 击 方法 
称 是 onClick， 长 按 方法 的 名 称 是 onLongClick。 
B203 哪个 视图 要 响应 点 击 或 长 按 ， 就 给 哪个 视图 注册 对 应 的 监听 器 对 象 。 点 寺 
册 方 法 是 setOnClickListener， 长 按 事件 的 注册 方法 是 setOnLongClickListener。 




















代 

















下 面 是 给 Button 对 象 注册 点 击 监听 器 和 长 按 监 听 器 的 页 面 代码 


public class ClickActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_click); 
/ 从 布局 文件 中 获取 名 叫 bn_click 的 按钮 控件 
Button btn_click = findViewById(R.id.btn_click); 
/ 给 btn_click 设置 点 击 监听 器 ， 一 旦 用 户 点 击 按钮 ， 就 触发 监听 器 的 onClick 方法 
btn_click.setOnClickListener(new MyOnClickListener()); 
/ 给 btn_click 设置 长 按 监听 器 ,一旦 用 户 长 按 按钮 ， 就 触发 监听 器 的 onLongClick 方法 
btn_click.setOnLongClickListener(new MyOnLongClickListener()); 


} 


/ 定义 一 个 点 击 监听 器 ， 它 实现 了 接口 View.OnClickListener 
class MyOnClickListener implements View.OnClickListener { 
@Override 
public void onClick(View v) { V 点 击 事件 的 处 理 方法 
if(v.getId() 一 R.id.btn_click) { // 判断 是 否 为 btn_click 被 点 击 
Toast.makeText(ClickActivity.this, "您 点 击 了 控件 : " +((TextView) V).getText()， 
Toast.LENGTH_SHORT).show(); 
上 
}; 
» 


// 定义 一 个 长 按 监听 器 ， 它 实现 了 接口 View.OnLongClickListener 
class MyOnLongClickListener implements View.OnLongClickListener { 
(@Override 
public boolean onLongClick(View v) { // 长 按 事 件 的 处 理 方法 
许 (vgetId0 一 R.id.btn_click) { // 判断 是 否 为 btn_click 被 长 按 
Toast.makeText(ClickActivity.this, "您 长 按 了 控件 : " + ((TextView) v).getText()， 
ToastLENGTH SHORT).show0; 


的 名 
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Teturn true; 


2.3.3 图 像 视图 ImageView 
ImageView 是 图 像 显示 控 件 ， 与 图 形 显示 有 关 的 属性 说 明 如 下 。 
e@ scaleType: 指定 图 形 的 拉 伸 类 型 ， 默 认 是 fitCenter。 拉 伸 类 型 的 取 值 说 明 见 表 2-8。 
e@ src: 指定 图 形 来 源 ，src 图 形 按照 scaleType 拉 伸 。 注 意 背景 图 不 按 scaleType 指定 的 
方式 拉 伸 ， 背 景 默 认 以 fitXY 方式 拉 伸 。 
表 2-8 拉 伸 类 型 的 取 值 说 明 
XML 中 的 拉 伸 类 型 | ScaleType 类 中 的 拉 伸 类 型 | 说 明 














fitXY FIT_XY 拉 伸 图 片 使 其 正好 填 满 视图 (图 片 可 能 被 拉 伸 变形 
fitStart FIT_START 保持 宽 高 比例 ， 拉 伸 图 片 使 其 位 于 视图 上 方 或 左 侧 
fitCenter FIT_CENTER 保持 宽 高 比例 ， 拉 伸 图 片 使 其 位 于 视图 中 间 

fitEnd FIT_END 保持 宽 高 比例 ， 拉 伸 图 片 使 其 位 于 视图 下 方 或 右 侧 
center CENTER 保持 图 片 原 尺寸 ， 并 使 其 位 于 视图 中 间 

centerCrop CENTER_CROP 拉 伸 图 片 使 其 充满 视图 ， 并 位 于 视图 中 间 
centerInside CENTER_INSIDE 保持 宽 高 比例 , 缩小 图 片 使 之 位 于 视图 中 间 (只 缩小 


不 放大 )。 当 图 片 尺寸 大 于 视图 时 ，centerInside 等 同 
于 fitCenter; 当 图 片 尺寸 小 于 视图 时 ，centerInside 
等 同 于 center 





ImageView 在 代码 中 调用 的 方法 说 明 如 下 。 
setScaleType: 设置 图 形 的 拉 伸 类 型 。 具 体 的 取 值 说 明 见 表 2-8。 
setImageDrawable: 设置 图 形 的 Drawable 对 象 。 
setImageResource: 设置 图 形 的 资源 ID。 
setImageBitmap: 设置 图 形 的 位 图 对 象 。 

读者 应 该 注意 到 ImageView 的 拉 伸 类 型 种 类 繁多 、 文 字 说 明 不 易 理 解 ， 特 别 是 center 相 
关 的 类 型 就 有 4 种 : fitCenter、center、centerCrop 、centerInside。 接 下 来 进行 一 个 实验 ， 把 一 
张 图 片 放 入 ImageView 控件 ， 尝 试 使 用 不 同 的 拉 伸 类 型 ， 看 看 效果 有 什么 区 别 。 下 面 是 图 片 
拉 伸 演示 用 的 代码 示例 : 

// 页 面 类 直接 实现 点 击 监听 器 的 接口 View.OnClickListener 

public class ScaleActivity extends AppCompatActivity implements View.OnClickListener { 

private ImageView iv_scale; / 声明 一 个 图 像 视 图 的 对 象 





(@Override 
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protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_scale); 
// 从 布局 文件 中 获取 名 叫 iv_scale 的 图 像 视图 
iv_scale = findViewById(R.id.iv_scale); 
// 下 面 通过 七 个 按钮 ， 分 别 演示 不 同 拉 伸 类 型 的 图 片 拉 伸 效果 
findViewById(R.id.btn_center).setOnClickListener(this); 
findViewById(R.id.btn_fitCenter).setOnClickListener(this); 
findViewById(R.id.btn_centerCrop).setOnClickListener(this); 
findViewById(R.id.btn_centerInside).setOnClickListener(this); 
findViewById(R.id.btn_fitXY).setOnClickListener(this); 
findViewById(R.id.btn_fitStart).setOnClickListener(this); 
findViewById(R.id.btn_fitEnd).setOnClickListener(this); 


@Override 
public void onClick(View v) { // 一 旦 监听 到 点 击 动作 ， 就 触发 监听 器 的 onClick 方法 

if (v.getId() 一 R.id.btn_center) { 
// 将 拉 伸 类 型 设置 为 “按照 原 尺寸 居中 显示 ” 
iv_scale.setScaleType(ImageView.ScaleType.CENTER); 

} else if (v.getId() 一 R.id.btn_fitCenter) { 
// 将 拉 伸 类 型 设置 为 “保持 宽 高 比例 ， 拉 伸 图 片 使 其 位 于 视图 中 间 ” 
iv_scale.setScaleType(ImageView.ScaleType.FIT_CENTER); 

} else if (v.getId() 一 R.id.btn_centerCrop) { 
// 将 拉 伸 类 型 设置 为 “ 拉 伸 图 片 使 其 充满 视图 ， 并 位 于 视图 中 间 ” 
iv_scale.setScaleType(ImageView.ScaleType.CENTER_CROP); 

} else if (v.getId() 一 R.id.btn_centerInside) { 
// 将 拉 伸 类 型 设置 为 “保持 宽 高 比例 ， 缩 小 图 片 使 之 位 于 视图 中 间 (只 缩小 不 放大 )” 
iv_scale.setScaleType(ImageView.ScaleType.CENTER_INSIDE); 

} else if (v.getId() 一 R.id.btn_fitXY) { 
// 将 拉 伸 类 型 设置 为 “ 拉 伸 图 片 使 其 正好 填 满 视图 (图 片 可 能 被 拉 伸 变 形 )” 
iv_scale.setScaleType(ImageView.ScaleType.FIT_XY); 

} else if (v.getId() 一 R.id.btn_fitStart) { 
// 将 拉 伸 类 型 设置 为 “保持 宽 高 比例 ， 拉 伸 图 片 使 其 位 于 视图 上 方 或 左 侧 ” 
iv_scale.setScaleType(ImageView.ScaleType.FIT_START); 

} else if (v.getId() 一 R.id.btn_fitEnd) { 
// 将 拉 伸 类 型 设置 为 “保持 宽 高 比例 ， 拉 伸 图 片 使 其 位 于 视图 下 方 或 右 侧 ” 
iv_scale.setScaleType(ImageView.ScaleType.FIT_END); 


} 
至 于 图 像 拉 伸 的 演示 界面 ，fitCenter 的 效果 如 图 2-11 所 示 ， 图 片 被 拉 伸 但 未 超出 控件 范 
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围 ，center 的 效果 如 图 2-12 所 示 ， 图 片 没有 拉 伸 ; centerCrop 的 效果 如 图 2-13 所 示 ， 图 片 被 
拉 伸 且 已 超出 控件 范围 ，centerInside 的 效果 如 图 2-14 所 示 ， 图 片 没有 被 拉 伸 。 


EE 

















图 2-11 ”fitCenter 的 效果 图 图 2-12 center 的 效果 图 
图 2-13 ”centerCrop 的 效果 图 图 2-14 ”centerInside 的 效果 图 
Android 能 用 ImageView 展示 图 片 ， 也 自 带 屏幕 截图 功能 。 尽 管 自 带 的 屏蔽 截图 功能 有 些 
简单 ， 不 过 多 数 场合 已 经 够 用 了 。 因 为 截图 功能 面向 所 有 视图 ,所 以 可 以 从 其 他 控件 或 布局 那 





里 截图 下 来 ， 然 后 显示 在 ImageView 上 面 。 
使 用 截图 功能 必须 通过 代码 完成 ， 相 关 方 法 如 下 〈 这 些 方法 都 来 自 于 View 类 ) 。 

setDrawingCacheEnabled: 设置 绘图 缓存 的 可 用 状态 。true 表示 打开 ，false 表示 关闭 。 

isDrawingCacheEnabled: 判断 该 控件 的 绘图 缓存 是 否 可 用 。 

setDrawingCacheQuality: 设置 绘图 缓存 的 质量 。 

getDrawingCache: 获取 该 控件 的 绘图 缓存 结果 ， 和 返回 值 为 Bitmap 类 型 。 

setDrawingCacheBackgroundColor: 设置 绘图 缓存 的 背景 颜色 。 大 家 可 能 会 奇怪 为 何 要 

提供 该 方法 ， 因 为 绘图 缓存 默认 背景 色 是 黑色 ， 如 果 不 提前 设置 缓存 的 背景 色 ， 截 图 

的 结果 就 是 黑 乎 平一 片 ， 所 以 需要 将 背景 色 设置 为 默认 颜色 (通常 是 白色 ) 。 


操作 截图 功能 的 具体 步骤 如 下 : 
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人 EDi) 开始 截图 前 ， 先 调用 setDrawingCacheEnabled 方法 ， 设 置 绘 图 缓存 为 可 用 状态 。 注 意 
该 方法 在 一 开始 就 得 调用 ， 因 为 先 开 启 绘图 缓存 ， 之 后 变更 的 界面 才 会 记录 到 缓存 中 ; 如 果 先 变更 
界面 再 开启 绘图 缓存 ， 缓 存 里 就 是 空 的 。 

E3702 调用 getDrawingCache 方法 获取 缓存 中 的 图 像 数据 。 

C703 完成 截图 , 延迟 若干 毫秒 后 调用 setDrawingCacheEnabled 方法 关闭 绘图 缓存 。 如 果 接 
下 来 还 要 截图 ， 就 再 次 调用 setDrawingCacheEnabled 方法 重新 开启 绘图 缓存 。 


下 面 是 完成 截图 功能 的 关键 代码 片段 : 


public void onClick(View v) { // 一 旦 监听 到 点 击 动作 ， 就 触发 监听 器 的 onClick 方法 
让 (v.getId0 一 Rid.btn_chat) { // 点 击 了 聊天 按钮 ， 则 给 文本 视图 添加 聊天 文字 
int random = (int) (Math.random() * 10) % 5; 
/ 下 面 的 DateUtil 参见 本 书 附带 源码 中 的 DateUtil.java 
String newStr = String.format("%s\n%s %s", 
tv_capture.getText().toString(), DateUtil.getNowTime(), mChatStr[random]); 
tv_capture.setText(newStr); 
} else if (v.getId() 一 R.id.btn_capture) { // 点 击 了 截图 按钮 , 则 将 截图 信息 显示 在 图 像 视图 上 
// 从 文本 视图 tv_capture 的 绘图 缓存 中 获取 位 图 对 象 
Bitmap bitmap = tv_capture.getDrawingCache(); 
// 给 图 像 视图 iv_capture 设置 位 图 对 象 
iv_capture.setImageBitmap(bitmap); 
/ 注意 这 里 在 截图 完毕 后 不 能 马上 关闭 绘图 缓存 ， 因 为 画面 演 染 需要 时 间 ， 
/ 如 果 立 即 关闭 缓存 ， 泻 染 画面 就 会 找 不 到 位 图 对 象 ， 会 报错 : 
/ “java.lang.lllegalArgumentException: Cannot draw recycled bitmaps”。 
/ 所 以 要 等 界面 泻 染 完成 后 再 关闭 绘图 缓存 ， 下 面 的 做 法 是 延迟 200 毫秒 再 关闭 
mHandler.postDelayed(mResetCache, 200); 














































































































上 


private HandlermHandler= new Handler(); / 声明 一 个 任务 处 理 器 
private Runnable mResetCache = new Runnable() { 
@Override 
public void run() { 
// 关闭 图 像 视图 tv_capture 的 绘图 缓存 
tv_capture.setDrawingCacheEnabled(false); 
/ 开启 图 像 视图 tv_capture 的 绘图 缓存 
tv_capture.setDrawingCacheEnabled(true); 


3 
对 应 的 截图 演示 界面 如 图 2-15 和 图 2-16 所 示 。 其 中 ， 图 2-15 所 示 为 截图 前 的 界面 ， 图 
2-16 所 示 为 截图 后 的 界面 。 


第 2 章 初级 控件 | 43 








3:15:08 我 们 去 看 电影 吧 。 3:15:08 我 们 去 看 电影 吧 。 13:15:08 我 们 去 看 电影 吧 。 
3:15:09 晚上 干什么 好 呢 了 3:15:09 晚上 干什么 好 呢 ? 13:15:09 晚上 干什么 好 呢 ? 
3:15:11 晚上 干什么 好 呢 ? 3:15:11 晚上 干什么 好 呢 了 13:15:11 晚上 于 什么 好 呢 ? 


3:15:49 我 们 去 看 电影 吧 。 13:15:49 我 们 去 看 电影 吧 。 
3:15:50 你 吃饭 了 吗 ? 13:15:50 你 吃饭 了 吗 ? 





聊天 蕊 图 聊天 蕊 图 
2-15 “截图 前 只 有 左边 有 文字 2-16 ”截图 后 在 右边 显示 图 片 


2.3.4 图 像 按 钮 ImageButton 


ImageButton 其 实 派生 自 ImageView， 而 不 是 派生 自 Button，ImageView 拥有 的 属性 和 方 
法 ，ImageButton 统统 拥有 ， 只 是 ImageButton 有 个 默认 的 按钮 外 观 。 

ImageButton 和 Button 都 起 到 控制 按钮 的 作用 , 不 同 的 是 Button 是 文本 按钮 , ImageButton 
是 图 像 按钮 ， 这 两 个 按钮 的 主要 区 别 在 于 : 


(1) Button 既 可 显示 文本 也 可 显示 图 形 〈 通 过 设置 背景 图 ) ， 而 ImageButton 只 能 显示 
图 形 不 能 显示 文本 。 

(2) ImageButton 上 的 图 像 可 按 比例 拉 伸 ， 而 Button 上 的 大 图 会 拉 伸 变形 (因为 背景 图 
无 法 按 比例 拉 伸 ) 。 

(3) Button 只 能 在 背景 显示 一 张 图 形 ， 而 ImageButton 可 分 别 在 前 景 和 背景 显示 两 张 图 
形 ， 实 现 图 片 车 加 的 效果 。 

从 上 面 可 以 看 出 ，Button 与 ImageButton 各 有 千秋 ， 通 常情 况 下 使 用 Button 就 够 用 了 。 但 
在 某 些 场合 ， 比 如 输入 法 打 不 出 来 的 字符 和 以 特殊 字体 显示 的 字符 串 ， 就 适合 先 切 图 再 用 
ImageButton 显示 。 

现在 有 了 Button 可 在 按钮 上 显示 文字 , 又 有 ImageButton 可 在 按钮 上 显示 图 形 , 照 理 说 绝 
大 多 数 场合 都 够 用 了 。 可 是 现实 项 目 中 的 需求 往往 十 分 怪异 , 例如 客户 要 求 在 按钮 文字 的 左边 
加 一 个 图 标 , 这 样 按钮 内 部 既 有 文字 又 有 图 片 , 乍 看 之 下 Button 和 ImageButton 都 没 法 直接 使 
用 。 若 把 图 标 和 文字 放 在 一 起 切 图 , 每 次 图 标 与 文字 的 大 小 或 距离 发 生变 化 时 岂 不 是 都 要 重新 
切 图 ? 若 用 LinearLayout 对 ImageView 和 TextView 组 合 布局 ， 这 样 固然 可 行 ， 但 是 布局 文件 
会 见长 许多 。 

其 实 有 个 既 简 单 又 灵活 的 办 法 ， 要 想 在 文字 周围 放置 图 片 ， 使 用 TextView 就 能 实现 ， 那 
么 基于 TextView 的 Button 自然 能 实现 。 具 体 可 在 XML 布局 文件 中 设置 以 下 5 个 属性 。 


drawableTop: 指定 文本 上 方 的 图 形 。 
drawableBottom: 指定 文本 下 方 的 图 形 。 
drawableLeft: 指定 文本 左边 的 图 形 。 
drawableRight: 指定 文本 右边 的 图 形 。 

















44 


e@ drawablePadding: 指定 图 形 与 文本 的 间距 。 


若 在 代码 中 实现 ， 则 可 调用 如 下 方法 。 


e setCompoundDrawables: 设置 文本 周围 的 图 形 。 可 分 别 设 置 左边 、 上 边 、 右 边 、 
的 图 形 。 





e@ setCompoundDrawablePadding: 设置 图 形 与 文本 的 间距 。 
下 面 的 代码 演示 在 按钮 中 变换 图 标 位 置 的 功能 : 
public class IconActivity extends AppCompatActivity implements View.OnClickListener { 


private Button btn_icon; / 声明 一 个 按钮 对 象 
private Drawable drawable; / 声明 一 个 图 形 对 象 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


} 


super.onCreate(savedInstanceState); 

setContentView(R.layout.activity_icon); 

// 从 布局 文件 中 获取 名 叫 btn_icon 的 按钮 控件 

btn_icon = findViewById(R.id.btn_icon); 

// 从 资源 文件 ic_launcherpng 中 获取 图 形 对 象 

drawable = getResources().getDrawable(R.mipmap.ic_launcher); 

/ 设置 图 形 对 象 的 矩形 边界 大 小 ， 注 意 必须 设置 图 片 大 小 ， 否 则 不 会 显示 图 片 
drawable.setBounds(0, 0, drawable.getMinimum Width(), drawable.getMinimum Height()); 
// 下 面 通过 四 个 按钮 ， 分 别 演示 左 、 上 、 右 、 下 四 个 方向 的 图 标 效果 
findViewById(R.id.btn_left).setOnClickListener(this); 
findViewById(R.id.btn_top).setOnClickListener(this); 
findViewById(R.id.btn_right).setOnClickListener(this); 
findViewById(R.id.btn_bottom).setOnClickListener(this); 


@Override 
public void onClick(View v) { // 一 旦 监听 到 点 击 动作 ， 就 触发 监听 器 的 onClick 方法 


让 (v.getId0 一 R.id.btn_left) { 
/ 设置 按钮 控件 btn_icon 内 部 文字 左边 的 图 标 
btn_icon.setCompoundDrawables(drawable, null, null, nulD); 
} else if (v.getId() 一 R.id.btn_top) { 
// 设置 按钮 控件 btn_icon 内 部 文字 上 方 的 图 标 
btn_icon.setCompoundDrawables(null, drawable, null, null); 
} else 让 (v.getId0 一 R.id.btn right) { 
// 设置 按钮 控件 btn_icon 内 部 文字 右边 的 图 标 
btn_icon.setCompoundDrawables(null, null, drawable, nulD); 
} else if (v.getId| 一 R.id.btn_bottom) { 
// 设置 按钮 控件 btn_icon 内 部 文字 下 方 的 图 标 
btn_icon.setCompoundDrawables(null, null, null, drawable); 


下 边 
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} 


变换 图 标 位 置 的 效果 界面 如 图 2-17 (图 标 在 文字 左边 ) 、 图 2-18 (图 标 在 文字 右边 )〉、 
图 2-19 (图 标 在 文字 上 边 ) 、 图 2-20 (图 标 在 文字 下 边 ) 所 示 。 











有 热烈 欢迎 热烈 欢迎 上 
图 标 在 左 图 标 在 上 图 标 在 右 图 标 在 下 图 标 在 左 图 标 在 上 图 标 在 右 图 标 在 下 
图 2-17 图 标 在 文字 左边 图 2-18 图 标 在 文字 右边 
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热烈 欢迎 一 
图 标 在 左 图 标 在 上 图 标 在 右 图 标 在 下 图 标 在 左 图 标 在 上 图 标 在 右 图 标 在 下 
图 2-19 图 标 在 文字 上 边 图 2-20 图 标 在 文字 下 边 
2.4 ”图 形 基础 


本 节 介 绍 Android 图 形 的 基本 概念 和 几 种 常见 图 形 的 使 用 方法 ， 主 要 包括 状态 列表 图 形 
StateListDrawable 的 定义 与 使 用 、 形 状 图 形 ShapeDawable 的 定义 与 使 用 、 九 宫 格 图 片 〈 点 九 
图 片 ) 的 制作 与 适用 场景 等 。 


2.4.1 图 形 Drawable 


Android 把 所 有 显示 出 来 的 图 形 都 抽象 为 Drawable (可 绘制 的 ) 。 这 里 的 图 形 不 止 是 图 片 ， 
还 包括 色 块 、 画 板 、 背 景 等 。 
drawable 文件 放 在 res 目录 的 各 个 drawable 目录 下。\res\drawable 一 般 存 放 的 是 描述 性 的 
XML 文件 ， 图 片 文件 一 般 放 在 具体 分 辨 率 的 drawable 目录 下 。 例 如 : 
e@ drawable-ldpi 里 面 存放 低 分 辩 率 的 图 片 (如 240x320) ， 现 在 基本 没有 这 样 的 智能 手 
机 了 。 
e@ drawable-mdpi 里 面 存放 中 等 分 辨 率 的 图 片 (如 320 x 480) ， 这 样 的 智能 手机 已 经 很 
证 全 
e@ drawable-hdpi 里 面 存放 高 分 辩 率 的 图 片 (如 480 x 800 ) ， 一 般 对 应 4 英寸 ~4.5 英寸 
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的 手机 ( 但 不 绝对 ， 同 尺寸 的 手机 有 可 能 分 辨 率 不 同 ， 手 机 分 辨 率 就 高 不 就 低 ， 因 为 
分 辨 率 低 了 屏幕 会 有 模糊 的 感觉 ) 。 
e@ drawable-xhdpi 里 面 存 放 加 高 分 辩 率 的 图 片 (如 720 x 1280) ， 一 般 对 应 5 英寸 ~5.5 


英寸 的 手机 。 

e@ drawable-xxhdpi 里 面 存 放 超 高 分 辩 率 的 图 片 (如 1080 x 1920) ,一般 对 应 6 英寸 ~ 6.5 
英寸 的 手机 。 

@ drawable-xxxhdpi 里 面 存放 超 超 高 分 辩 率 的 图 片 ( 如 1440 x 2560 ) ， 一 般 对 应 7 英寸 
以 上 的 平板 电脑 。 


基本 上 ， 分 辩 率 每 加 大 一 级 ， 宽 度 和 高 度 就 要 加 大 二 分 之 一 或 三 分 之 一 像素 。 如 果 各 目 
录 存 在 同名 图 片 ，Android 就 会 根据 手机 的 分 辨 率 分 别 适 配对 应 文件 夹 里 的 图 片 。 在 开发 App 
时 , 为 了 兼容 不 同 的 手机 屏幕 ,根据 需求 在 各 目录 存放 不 同 分 辨 率 的 图 片 才 能 达到 最 合适 的 显 
示 效 果 。 例 如 ， 在 drawable-hdpi 放 了 一 张 背 景 图 片 bg.png( 分 辩 率 480X800) ， 其 他 目录 没 
放 ， 使 用 分 辨 率 480X 800 的 手机 查看 该 App 没有 问题 ,但 是 使 用 分 辨 率 720X 1280 的 手机 查 
看 App 会 发 现 背 景 图 片 有 点 模糊 ,原因 是 Android 为 了 让 bg.png 适 配 高 分 辨 率 的 屏幕, 把 bg.png 
拉 伸 到 了 720X1280， 拉 伸 的 后 果 是 图 片 变 得 模糊 。 

开发 者 拿 到 一 张 图 片 ， 可 以 直接 复制 粘贴 到 drawable 目录 ， 也 可 以 通过 批量 drawable 插 
件 Android Postfix Completion 生成 并 导入 各 分 辩 率 的 图 片 ,该 插件 的 安装 和 使 用 方法 参见 第 1 
章 的 “1.5.3 安装 常用 插件 ”。 

在 XML 布局 文件 中 引用 drawable 文件 可 使 用 “@drawable/***” 这 种 形式 , 如 background 
属性 、ImageView 和 ImageButton 的 src 属性 、TextView 和 Button 的 drawableTop 系列 属性 都 
可 以 引用 drawable 文件 。 

在 代码 中 引用 drawable 文件 可 分 为 两 种 情况 : 


(1) 使 用 setBackgroundResource 和 setImageResource 方法 , 可 直接 在 参数 中 指定 drawable 
文件 的 资源 ID， 例 如 “R.drawable.***”。 

(2) 使 用 setBackgroundDrawable、setImageDrawable 和 setCompoundDrawables 等 方法 ， 
参数 是 Drawable 对 象 ， 这 时 得 先 从 资源 文件 中 生成 Drawable 对 象 ， 示 例 代码 如 下 : 


// 从 资源 库 里 的 图 片 文件 apple.png 获取 图 形 对 象 
Drawable drawable = getResources().getDrawable(R.drawable.apple); 


2.4.2 ”状态 列表 图 形 


- 般 drawable 是 静态 图 形 ， 如 Button 按钮 的 背景 在 正常 情况 下 是 凸 起 的 ， 在 按 下 时 是 凹 

陷 的 ， 从 按 下 到 弹 起 的 过 程 , 用 户 便 能 知道 点 击 了 这 个 按钮 。 根 据 不 同 的 触摸 情况 变更 图 形 显 
示 ， 这 种 情况 会 用 到 Drawable 的 一 个 子 类 StateListDrawable， 该 子 类 在 XML 文件 中 定义 不 同 
状态 时 呈现 图 形 列表 。 要 想 在 项 目 中 创建 状态 图 形 的 XML 文件 ， 则 需 右 击 drawable 目录 ， 然 
后 在 右键 菜单 中 依次 选择 New 一 Drawable resource file， 即 可 自动 生成 一 个 空 的 XML 文件 。 

下 面 是 一 个 状态 列表 图 形 的 drawable 文件 : 

<selector xmlns:android="http://schemas.android.com/apk/res/android"> 

<item android:state_pressed="true" android:drawable="(@drawable/button_pressed" /> 
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<item android:drawable="(@drawable/button_normal" /> 
</selector> 


该 XML 定义 文件 中 的 关键 点 是 state_pressed， 值 为 true 表示 按 下 时 显示 button_pressed 
图 像 ， 其 余 情况 显示 button_normal 图 像 。 

为 方便 理解 ， 接 下 来 我 们 先 将 Button 控件 的 background 属性 设置 为 该 drawable 文件 ， 然 
后 在 屏幕 上 点 击 这 个 按钮 , 看 看 按 下 和 弹 起 时 分 别 呈 现 什么 效果 , 界面 如 图 2-21( 按 下 按钮 ) 、 
图 2-22〈 按 钮 弹 起 ) 所 示 。 





Junior Junior 


默认 样式 的 按钮 默认 样式 的 按钮 


定制 样式 的 按钮 


图 2-21 按 下 按钮 时 的 背景 样式 图 2-22 ”按钮 弹 起 时 的 背景 样式 


StateListDrawable 不 仅 用 于 Button 控件 , 而 且 可 以 用 于 其 他 拥有 不 同 状 态 的 控件 , 取决 于 
开发 者 对 StateListDrawable 状态 类 型 的 定义 。 状 态 类 型 的 取 值 说 明 见 表 2-9。 


表 2-9 状态 类 型 的 取 值 说 明 





状态 类 型 说 明 
state_pressed 
state_checked 
state_focused 


state_selected 
2.4.3 ”形状 图 形 


前 面 讲 到 可 在 XML 文件 中 描述 状态 列表 图 形 的 定义 ， 还 有 一 种 常用 的 XML 图 形 文件 ， 
是 描述 形状 定义 的 图 形 shape 图 形 。 用 好 shape 可 以 让 App 页 面 不 再 果 板 , 还 可 以 节省 美 
工 不 少 工作 量 。 

形状 图 形 的 定义 文件 以 shape 元 素 为 根 节点 。 根 节点 下 定义 了 6 个 节点 : corners( 圆 角 ) 、 
gradient (渐变 ) 、padding〈 间 隔 ) 、size (尺寸 ) 、solid (填充 ) 、stroke 〈 描 边 ) ， 各 节点 
的 属性 值 主要 是 长 宽 、 半 径 、 角 度 以 及 颜色 。 下 面 是 形状 图 形 各 个 节点 和 属性 的 简要 说 明 。 








1. shape 


shape 是 XML 文件 的 根 节点 ， 用 来 描述 该 形状 图 形 是 哪 种 几何 图 形 。 下 面 是 shape 节点 
的 常用 属性 说 明 。 


e shape: 字符 串 类 型 ， 图 形 的 形状 。 形状 类 型 的 取 值 说 明 见 表 2-10。 
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表 2-10 形状 类 型 的 取 值 说 明 


























形状 类 型 说 明 
rectangle 矩形。 默认 值 
oval | 椭圆 。 此 时 comers 节点 会 失效 
line | 直线 。 此 时 必须 设置 stroke 节点 ， 不 然 会 报错 
ring 环 
2. corners 


corners 是 shape 的 下 级 节点 ， 用 来 描述 4 个 圆 角 的 规格 定义 。 若 无 corners 节点 ， 则 表示 
没有 圆 角 。 下 面 是 corners 节点 的 常用 属性 说 明 。 


bottomLeftRadius: 像素 类 型 ， 左 下 圆 角 的 半径 。 

bottomRightRadius: 像素 类 型 ， 右 下 圆 角 的 半径 。 

topLeftRadius: 像素 类 型 ， 左 上 圆 角 的 半径 。 

topRightRadius: 像素 类 型 ， 右 上 圆 角 的 半径 。 

radius: 像素 类 型 ， 圆 角 半径 ( 若 有 上 面 4 个 圆 角 半 径 的 定义 ， 则 不 需要 radius 定义 ) 。 





3. gradient 
gradient 是 shape 的 下 级 节点 ， 用 来 描述 形状 内 部 的 颜色 渐变 定义 。 若 无 gradient 节点 ， 
则 表示 没有 渐变 效果 。 下 面 是 gradient 节点 的 常用 属性 说 明 。 
。 angle: 整 型 ， 渐 变 的 起 始 角度 。 为 0 时 表示 时 钟 的 9 点 位 置 ， 值 增 大 表示 往 逆 时 针 方向 旋转 。 
例如 ， 值 为 90 表示 6 点 位 置 ， 值 为 180 表 示 3 点 位 置 ， 值 为 270 表示 0 点 /12 点 位 置 。 
e type: 字符 串 类 型 ， 渐 变 类 型 。 渐 变 类 型 的 取 值 说 明 见 表 2-11。 


表 2-11 渐变 类 型 的 取 值 说 明 








线性 渐变 ， 默 认 值 
放射 渐变 ， 起 始 颜色 就 是 圆心 颜色 
滚动 渐变 ， 即 一 个 线段 以 某 个 端点 为 圆心 做 360 度 旋转 










Tadial 








sweep 





e@ centerX: 浮 点 型 ， 圆 心 的 X 坐标 。 当 android:type="linear" 时 不 可 用 。 

@ centerY: 浮 点 型 ， 圆 心 的 Y 坐标 。 当 android:type="linear" 时 不 可 用 。 

e@ gradientRadius: 整 型 ， 渐 变 的 半径 。 当 android:type="radial" 时 才 需 要 设置 该 属性 。 
ecenterColor: 颜色 类 型 ， 渐 变 的 中 间 颜 色 。 

e startColor: 颜色 类 型 ， 渐 变 的 起 始 颜色 。 

e endColor: 颜色 类 型 ， 渐 变 的 终止 颜色 。 

e@ useLevel: 布尔 类 型 ， 设 置 为 true 无 渐变 色 、false 有 渐变 色 。 

4. padding 











padding 是 shape 的 下 级 节点 ， 用 来 描述 形状 图 形 与 周围 视图 的 间隔 大 小 。 若 无 padding 
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节点 ， 则 表示 四 周 不 设 间隔 。 下 面 是 padding 节点 的 常用 属性 说 明 。 
bottom: 像素 类 型 ， 与 下 边 的 间隔 。 

left: 像素 类 型 ， 与 左边 的 间隔 。 

right: 像素 类 型 ， 与 右边 的 间隔 。 

top: 像素 类 型 ， 与 上 边 的 间隔 。 


5. size 

size 是 shape 的 下 级 节点 ， 用 来 描述 形状 图 形 的 尺寸 大 小 〈 宽 度 和 高 度 ) 。 若 无 size 节点 ， 
则 表示 宽 高 自 适应 。 下 面 是 size 节点 的 常用 属性 说 明 。 

e height: 像素 类 型 ， 图 形 高 度 。 

e width: 像素 类 型 ， 图 形 宽 度 。 

6. solid 

solid 是 shape 的 下 级 节点 ， 用 来 描述 形状 图 形 内 部 的 填充 色彩 。 若 无 solid 节点 ， 则 表示 
无 填充 颜色 。 下 面 是 solid 节点 的 常用 属性 说 明 。 

e@ color: 颜色 类 型 ， 内 部 填充 的 颜色 。 

7. stroke 

stroke 是 shape 的 下 级 节点 ， 用 来 描述 形状 图 形 四 周边 线 的 规格 定义 。 若 无 stroke 节点 ， 
则 表示 不 存在 描 边 。 下 面 是 stroke 节点 的 常用 属性 说 明 。 


color: 颜色 类 型 ， 描 边 的 颜色 。 

dashGap: 像素 类 型 ， 每 段 虚线 之 间 的 间隔 。 

dashWidth: 像素 类 型 ， 每 段 虚线 的 宽度 。 

width: 像素 类 型 ， 描 边 的 厚度 。 若 dashGap 和 dashWidth 有 一 个 值 为 0， 则 描 边 为 实 
线 。 


在 实际 开发 中 ， 常 用 的 有 3 个 节点 : corners〈 圆 角 ) 、solid (填充 ) 和 stroke〈 描 边 ) 。 
shape 根 节点 的 属性 一 般 不 用 设置 (默认 矩形 就 好 了 )〉。 下 面 是 一 个 shape 图 形 的 XML 描述 
文件 代码 : 

<shape xmlns:android="http://schemas.android.com/apk/res/android" > 


<!-- 指定 了 形状 内 部 的 填充 颜色 --> 
<solid android:color="#ffdd66" /> 


<!-- 指定 了 形状 边线 的 粗细 与 颜色 -> 
<stroke 
android:width="1dp" 
android:color="#ffaaaaaa" /> 
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<!-- 指定 了 形状 四 个 圆 角 的 半径 --> 
<corners 
android:bottomLeftRadius="10dp" 
android:bottomRightRadius="10dp" 
android:topLeftRadius="10dp" 
android:topRightRadius="10dp" /> 
</shape> 


对 应 的 形状 图 形 效果 界面 如 图 2-23 所 示 。 该 形状 为 一 个 贺 角 算 形 ， 内 部 填充 色 为 土 黄色 ， 





国 角 矩 形 背 录 桶 贺 背 录 
2-23 shape 文件 定义 的 圆 角 矩形 效果 
现在 有 个 需求 ， 客 户 要 求 在 界面 上 增加 一 个 水 平分 割 线 ， 如 果 是 你 会 怎么 做 呢 ? 按照 目 
前 为 止 的 学 习 成 果 有 以 下 3 个 办 法 。 
(1) 在 TextView 控件 中 连续 填 入 许多 横 线 或 下 划 线 。 
(2) 让 美工 做 一 个 横 线 的 切 图 ， 然 后 将 ImageView 控件 塞 进 横 线 图 。 
(3) 使 用 刚 学 的 shape， 根 节点 的 shape 属性 设置 为 line 表示 直线 图 形 。 


以 上 做 法 各 有 千秋 ， 不 过 杀 鸡 焉 用 牛刀 ， 简 单 的 事情 自然 有 简单 的 办 法 。 最 简单 的 做 法 
是 在 布局 文件 中 增加 一 个 View 控件 ， 高 度 设置 为 1tp、 背 景 颜 色 设 置 为 线条 颜色 ， 这 样 便 实 
现 了 水 平分 割 线 的 需求 。XML 文件 的 示例 代码 如 下 : 
<View 
android:layout_width="match_parent" 
android:layout_height="1dp" 
android:background="#000000" /> 


2.4.4 九宫 格 图 片 
前 面 在 介绍 ImageView 时 专门 举 了 例子 说 明 不 同 拉 伸 类 型 下 的 图 片 显示 效果 。 当 图 片 被 


拉 大 时 ， 画 面容 易 模糊 ， 如 果 把 图 片 作为 背景 图 ， 模 糊 的 情况 会 更 严重 。 如 图 2-24 所 示 ， 
张 按钮 图 片 被 拉 得 很 宽 ， 此 时 左右 两 边 的 边缘 线 既 变 宽 又 变 模糊 了 。 
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普通 图 片 背景 


九宫 格 图 片 背 季 





图 2-24 普通 图 片 与 九宫 格 图 片 的 拉 伸 效 果 对 比 


为 了 解决 这 个 问题 ，Android 专门 设计 了 点 九 图 片 。 点 九 图 片 的 扩展 名 是 png， 文 件 名 后 
常 带 有 “.9” 字 样 。 因 为 把 一 张 图 片 划分 成 了 3X3 的 九宫 格 区 域 ， 所 以 得 名 点 九 图 片 ， 也 叫 
九宫 格 图 片 。 如 果 背 景 是 一 个 shape 图 形 ， 其 stroke 节点 的 width 属性 已 经 设置 了 具体 的 像素 
值 (如 1dp) ， 那 么 无 论 该 shape 图 形 被 拉 伸 到 多 大 ， 描 边 宽度 始终 都 是 1tp。 点 九 图 片 的 实 
现 原理 与 shape 类 似 ， 即 拉 伸 图 形 时 ， 只 对 内 部 进行 拉 伸 ， 不 对 边缘 做 拉 伸 操作 。 

为 了 演示 九宫 格 图 片 的 展示 效果 ， 首 先 要 制作 几 张 点 九 图 片 。Android Studio 现 已 集成 了 
点 九 图 片 的 制作 工具 ， 首 先 找到 待 加 工 的 原始 图 片 button_pressed_orig.png， 右 击 它 弹 出 右键 
菜单 如 图 2-25 所 示 。 























7 Wjunior 


manifests eory CtrltC 

java Copy Path Ctrl+Shift+C 
res Copy as Plain Text 

Y Pdravible Copy Relative Path Ctrl+Alt+Shift+C 

» Paapplel.png Easte Ctrlty 

apple2.png 区 Jump te Source FA 


强 btn_nine_selector. ml ”图 Jump to External Editor Ctrl+Alt+F4 
强 btn_orig_selector, ml RE MF 
button_nornal. 9. png (hip Analyze 
9 button_nornal_oris. png 

司 button_prcsscd 9. png (hd 
button_pressed_orig. png 
党 shape_oval_rose. ml 

景 shape_rect_gold ml r tr1+A1t+ 
名 shape_vhite_rith_ stroke. Delete... Delete 


Refactor » 
Add to Favorites » 


ed Local History » 
ayont {5 Synchronize “button_pre™ed_orig. pne’ 
id Show in Explorer 

values 





File Path Ctrl+ALt4F12 
到 Compare With... Ctrl+D 
Compare File with Editor 





Gradle Console 






如 

EE BUILD SUCCESSFUL in 4s 
41 actionable tasks: 15 execute Set Background Inage 

OQ Create Gist... 












Pl: Rm HT000 mAndroid Profiler 
Connection attenpts: 1 (today 15:30) Convert to WebP... 


图 2-25 点 九 图 片 的 制作 菜单 路 径 
在 右键 菜单 中 选择 下 面 的 “Create 9-Patch files”， 并 在 随后 的 对 话 框 中 单 击 “OK” 按钮 。 
接着 drawable 目录 就 会 出 现 一 个 名 为 “button_pressed_orig.9.png” 的 图 片 文件 ， 双 击 该 文件 ， 
右 侧 弹出 点 九 图 片 的 加 工 窗口 如 图 2-26 所 示 。 
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Press Control/Shift while dragging on the bor: 





1oom: 100%@— 800 DShov lock ~ DO Shov content 
Patch scale: 2xW— 6x DShov patches DO Show bad patches 


-Patch | Inaeeriierditer| 











图 2-26 点 九 图 片 的 加 工 窗口 界面 


2-26 的 左 侧 窗 口 是 图 片 加 工区 域 ， 右 侧 窗口 是 图 片 预览 区 域 ， 从 上 到 下 依次 是 纵向 拉 
伸 预 览 、 横 向 拉 伸 预览 、 未 拉 伸 预览 。 在 左 侧 窗 口 图 片 四 周 的 马赛 到 处 单 击 会 出 现 一 个 黑 点 ， 
把 黑 点 左右 或 上 下 拖 动 会 拖 出 一 段 黑 线 ， 不 同方 向 上 的 黑 线 表 示 不 同 的 效果 。 

如 图 2-27 所 示 ， 界 面 上 边 的 黑 线 指 的 是 水 平方 向 的 拉 伸 区 域 。 水 平方 向 拉 伸 图 片 时 ， 只 
有 黑 线 区 域内 的 图 像 会 拉 伸 ， 黑 线 两 边 的 图 像 保持 原状 ， 从 而 保证 左右 两 边 的 边框 厚度 不 变 。 


Horizontal Patch: 17 - 102 px 





图 2-27 点 九 图 片上 边 的 边缘 线 


如 图 2-28 所 示 ， 界 面 左边 的 黑 线 指 的 是 垂直 方向 的 拉 伸 区 域 。 垂 直方 向 拉 伸 图 片 时， 只 
有 黑 线 区 域内 的 图 像 会 拉 伸 ， 黑 线 两 边 的 图 像 保 持原 状 ， 从 而 保证 上 下 两 边 的 边框 厚度 不 变 。 


[i 


Vertical ch: 14 ~ 24 px 
昌 





2-28 点 九 图 片 左边 的 边缘 线 
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如 图 2-29 所 示 ， 界 面 下 边 的 黑 线 指 的 是 该 图 片 作 为 控件 背景 时 ， 控 件 内 部 的 文字 左右 边 
界 只 能 放 在 黑 线 区 域内 。 这 里 Horizontal Padding 的 效果 就 相当 于 android:paddingLeft 与 
android:paddingRight。 


何 : 


Horizontal Padding: 9 - 110 px 


图 2-29 点 九 图 片 下 边 的 边缘 线 


如 图 2-30 所 示 ， 界 面 右边 的 黑 线 指 的 是 该 图 片 作 为 控件 背景 时 ， 控 件 内 部 的 文字 上 下 边 
界 只 能 放 在 黑 线 区 域内 。 这 里 Vertical Padding 的 效果 就 相当 于 android:paddingTop 与 
android:paddingBottom。 


Fae 





Vertical Padding: 9 - 30 px 





图 2-30 点 九 图 片 右边 的 边缘 线 


在 实际 开发 中 ， 前 两 个 属性 使 用 的 比较 多 ， 因 为 很 多 场景 都 要 求 拉 伸 图 片 时 要 保 真 。 后 
两 个 属性 一 般 用 得 不 多 ,但 若 不 知道 ， 遇 到 问题 还 挺 麻 烦 的 。 笔 者 以 前 做 开发 时 看 到 某 个 页 面 
的 文字 总 是 与 顶端 有 段 间 隔 ， 可 是 无 论 怎么 调整 XML 和 代码 都 没 法 缩小 间隔 ， 后 来 才 想起 来 
检查 该 页 面 的 背景 图 片 , 结果 打开 之 后 发 现 该 图 片 是 点 九 图 片 , 原来 在 水 平和 垂直 方向 都 设置 
了 padding， 这 才 解 决 了 一 大 困惑 。 


2.5 实战 项 目 : 简单 计算 器 


到 目前 为 止 , 虽然 只 学 了 一 些 Android 的 初级 控件 , 但 是 也 可 以 学 以 致 用 ,即便 只 有 这 些 
简单 的 布局 和 控件 ， 也 能 够 做 出 实用 的 App。 接 下 来 尝试 设计 并 实现 一 个 简单 计算 器 。 


2.5.1 设计 思路 


计算 器 是 人 们 日 常生 活 中 最 常用 的 工具 之 一 ， 无 论 在 电脑 上 还 是 手机 上 ， 都 少不了 计算 
器 的 身影 。 以 Windwos 上 的 计算 器 为 例 ， 界 面 简洁 且 十 分 实用 ， 程 序 界面 如 图 2-31 所 示 。 

这 个 计算 器 界面 主要 分 为 两 部 分 ， 一 部 分 是 上 面 的 文本 框 ， 用 于 显示 计算 结果 ; 另 一 部 
分 是 下 面 的 几 排 按钮 ， 用 于 输入 数字 与 各 种 运算 符 。 为 了 减少 复杂 度 ， 可 以 精简 一 些 功能 ， 只 
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保留 数字 与 加 、 减 、 乘 、 除 四 则 运算 ， 另 外 补充 一 个 开 根 号 〈 求 平方 根 ) 的 运算 。 至 于 App 
的 显示 界面 ,基本 与 习惯 的 计算 器 界面 保持 一 致 ， 经 过 对 操作 按钮 的 适当 排列 , 调整 后 的 设计 
效果 如 图 2-32 所 示 。 


Junior 


查看 (V) 编辑 (E) 


简单 计算 器 














4 5 6 - 

A 

0 mS 

图 2-31 Windows 的 计算 器 图 2-32 简单 计算 器 的 设计 效果 图 


这 个 计算 器 虽然 小 巧 ， 但 是 基本 讼 括 了 本 章 的 知识 点 ， 先 来 看 看 用 了 哪些 控件 。 


e 线性 布局 LinearLayout: 计算 器 界面 整体 上 是 从 上 往 下 布局 的 ， 所 以 需要 垂直 方向 的 
LinearLayout; 下 面部 分 每 行 都 有 4 个 按钮 ， 又 需要 水 平方 向 的 LinearLayout。 

e 滚动 视图 ScrollView: 虽然 计算 器 界面 不 宽 也 不 高 ， 但 是 以 防 万 一 ， 最 好 还 是 加 个 垂 
直方 向 的 ScrollView。 

e 文本 视图 TextView: 很 明显 上 方 标题 “简单 计算 器 ”就 是 TextView， 下 面 的 计算 结果 也 
需要 使 用 TextView， 而 且 是 能 够 自动 从 下 往 上 滚动 的 TextView， 即 聊天 室 效 果 的 文本 视 
图 。 

e 按钮 Button: 绝 大 多 数 数字 与 运算 符 按 钮 都 采用 Button 控件 。 

e@ 图 像 视 图 ImageView: 暂时 未 用 到 。 

。 图 像 按钮 ImageButton: 开 根 号 的 运算 符 “w?” 虽 然 能 够 打出 来 ， 但 是 右上 角 少 了 数学 
课本 上 的 一 横 , 所 以 该 按钮 要 用 一 张 标准 的 开 根 号 图 片 显 示 , 这 就 用 到 了 ImageButton 。 

e 状态 列表 图 形 : 每 个 按钮 都 有 按 下 和 弹 起 两 种 状态 ， 这 里 定制 了 按钮 控件 的 自 定义 样 
式 ， 因 此 用 到 了 状态 列表 图 形 。 

e 形状 图 形 : 运算 结果 用 到 的 文本 视图 边框 是 圆 角 和 盾 形 ， 所 以 得 给 它 定义 一 个 shape 文 
件 ， 把 shape 定义 的 图 角 和 矩形 作为 文本 视图 的 背景 。 

@ 九宫 格 图 片 : 注意 计算 器 界面 左下 角 的 “0”， 该 按钮 是 其 他 按钮 的 两 倍 宽 ， 如 果 使 
用 普通 图 片 当 背景 ， 势 必 造 成 边缘 线 被 拉 宽 、 拉 模糊 的 问题 ， 故 而 要 采用 点 九 图 片 避 
免 这 种 情况 。 


经 过 对 计算 器 效果 图 的 详细 分 析 ， 大 家 初步 了 解 了 所 运用 的 控件 技术 ， 接 下 来 就 可 以 对 
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界面 进行 布局 和 排列 了 。 
2.5.2 ”小 知识 : 日 志 Log/ 提 示 Toast 


在 正式 编码 之 前 ， 读 者 有 必要 了 解 一 下 Android 中 的 运行 信息 调试 手段 。 例 如 ， 开 发 C 
程序 时 , 程序 员 常 用 printf 函数 输出 程序 日 志 ; 开发 Java 程序 时 , 程序 员 常 用 System.out.println 
函数 输出 程序 日 志 。 同 样 ，App 开发 也 有 相应 的 函数 输出 提示 信息 。 提 示 信 息 可 分 为 两 类 , 一 
类 是 给 开发 者 看 的 ， 另 一 类 是 给 用 户 看 的 。 





1.Log 


给 开发 者 看 的 提示 信息 要 调用 Log 类 的 相应 方法 , 日 志 打印 结果 可 在 Android Studio 界面 
下 方 的 logcat 小 窗口 查看 。Log 类 各 种 方法 的 区 别 在 于 日 志 的 等 级 ， 具 体 说 明 如 下 。 


Log.e: 表示 错误 信息 ， 比 如 可 能 导致 程序 崩溃 的 异常 。 

Log.w: 表示 警告 信息 。 

Log.i: 表示 一 般 消息 。 

Log.d: 表示 调 \， 可 把 程序 运行 时 的 变量 值 打印 出 来 ， 方 便 跟 踪 调 试 。 

Log.v: 表示 宛 余 信息 。 
若 想 查看 App 的 运行 日 志 ， 可 单 击 Android Studio 底部 的 “Logcat” 标 签 ， 此 时 主 界面 的 

下 方 弹出 一 排 的 日 志 窗 口 ， 如 图 2-33 所 示 ， 从 日 志 看 出 正在 进行 的 运算 操作 是 “5*9=? ”。 


Leteat 


ba 
[oo0v por v3 mazoa 6.0, 157 SR [eo rompie. junior 755 BB es BB Gtivitye) Oneses | av my selected amlletlm 回 


05-21 18:38:40. 901 15259-15259/con. exanple. junior D/CalculatorActivity: Tesid: 6, Lnput Text=5 








轩 03-21 18:38:49.83L 15; mL exanple. junior D/CalculatorActivity: resid=: 4, inputText=x 
03-21 18:38:52, 744 15 m. example. junior D/CalculatorActivity: resid-2131165245 

03-21 18:38:54, 330 15 mL example. junior D/CalculatorActivity: resid-21311 
Bl: Rm BIO mdroid Profslor BEE 日 Iooainal BO: Mesoagos 八 Event Leg 国 Cradle Console 





图 2-33 Android Studio 的 日 志 查 看 窗口 


日 志 窗口 的 顶部 是 一 排 条 件 筛 选 控件 ， 从 左 到 右 依次 为 : 测试 机 型 的 名 称 〈 如 “DOOV 
V3”) 、 测 试 App 的 包 名 (例如 只 显示 com.example.junior 的 日 志 ) 、 查 看 日 志 的 级 别 〈 例 如 
只 显示 级 别 不 低 于 Verbose 即 Log.v 的 日 志 ) 、 上 日志 包含 的 字符 串 《〈 例 如 只 显示 包含 
CalculatorActivity 的 日 志 ) ， 还 有 最 后 一 个 是 筛选 控制 选项 〈( 其 中 “Show only selected 
application” 表 示 只 显示 选中 的 应 用 日 志 ， 而 “No Filters” 则 表示 不 进行 任何 条 件 过 滤 ) 。 

2. Toast 

给 用 户 看 的 提示 信息 要 调用 Toast 类 的 相应 方法 , 提示 文字 会 在 屏幕 下 方 以 一 个 小 窗口 临 
时 展现 。 对 于 计算 器 来 说 ， 有 好 几 种 情况 需要 提示 用 户 ， 如 “被 除数 不 能 为 0”“ 开 根 号 的 数 
值 不 能 小 于 0” 等 。 

Toast 的 简单 用 法 只 需 一 行 代码 就 可 以 了 ， 示 例 代 码 如 下 : 

ToastmakeText(MainActivity this, "提示 文字 ", Toast LENGTH_SHORT).show0; 

Toast 弹 窗 的 展示 效果 如 图 2-34 所 示 ， 此 时 App 发 现 了 被 除数 为 零 的 情况 。 


56 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


junior 


简单 计算 器 











图 2-34 被 除数 为 零 的 Toast 弹 窗 提示 


另外 ， 计 算 器 每 个 按钮 的 展示 风格 基本 相同 ， 为 了 减少 元 余 代码 ， 可 将 相同 的 样式 定义 
写 在 values 目录 下 的 styles.xml 文件 中 ， 然 后 在 布局 文件 节点 下 增加 style="@style/btn_cal" 这 
样 的 属性 定义 。 
2.5.3 ”代码 示例 


看 到 这 里 ， 估 计 读者 对 计算 器 App 的 布局 和 代码 框架 都 从 和音 计 和 中 
了 然 于 胸 了 ， 接 下 来 介绍 一 些 业务 逻辑 判断 与 基本 的 数学 四 。 198:7228 285714285773-84.35714 


198=7=28.2857142857x3=84.85714 








则 运算 。 只 要 设计 充分 并 且 合理 ,编码 就 会 很 快 。 计算 器 App 28571 

运行 后 的 计算 效果 如 图 2-35 所 示 。 CE + 2 |G 
编码 过 程 主要 分 为 3 个 步骤 : 8 人 
CT01 先 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 代码 文 4 5 6 

件 取 名 CalculatorActivityjava 、 布局 文件 取 名 1 2 3 oy 

activity_calculator.xml 。 记得 在 AndroidManifest.xml 中 注册 

acitivity 节点 ， 不 然 App 运行 时 会 报 ActivityNotFoundException 0 = 





异常 ， 具 体 是 在 application 节点 下 补充 一 行 声 明 : 图 2.35 简单 计算 器 的 运行 效果 图 


<activity android:name=".CalculatorActivity" > 
E302 在 res/layout 目录 下 创建 布局 文件 activity_calculator.xml, 按照 简单 计算 器 的 效果 图 在 
里 面 填 入 各 控件 的 布局 结构 ， 并 指定 相关 的 属性 定义 。 
C03 在 项 目的 包 名 目录 下 创建 CalculatorActivity 类 ， 仿 照 MainActivity 代码 在 onCreate 
内 部 的 setContentView 方法 中 填 入 参数 Rlayoutactivity_calculator ， 表 示 该 页 面 使 
activity_calculatorxml 中 定义 的 界面 布局 。 接 着 编写 具体 的 控件 操作 与 业务 代码 。 


下 面 是 计算 器 App 进行 加 减 乘除 的 代码 片段 示例 ， 完 整 代码 参见 本 书 附带 源码 junior 模 
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块 的 CalculatorActivity.java: 


private String operator= ""; // 操作 符 

private String firstNum = ""; / 前 一 个 操作 数 
private String nextNum = ""; // 后 一 个 操作 数 
private String result = ""; // 当前 的 计算 结果 
private String showText= "; / 显示 的 文本 内 容 


// 开始 加 减 乘除 四 则 运算 ， 计 算 成 功 则 返回 trwe， 计 算 失败 则 返回 false 
private boolean caculate() { 
让 (operator.equals(" 十 ")) { // 当前 是 相 加 运算 
result = String.valueOf( Arith.add(firstNum, nextNum)); 
} else if (operator.equals(" 一 ")) { // 当前 是 相 减 运算 
result = String.valueOf( Arith.sub(firstNum, nextNum)); 
} else if (operator.equals("X")) { // 当前 是 相 乘 运算 
result = String.valueOft Arith.mul(firstNum, nextNum)); 
} else if (operator.equals(" 二 ")) { // 当前 是 相 除 运算 
让 ("0".equalsCnextNum)) { // 发 现 被 除数 是 0 
/ 被 除数 为 0， 要 弹 窗 提示 用 户 
Toast.makeText(this, "被 除数 不 能 为 零 ", Toast.LENGTH_SHORT).show(); 
// 返回 false 表示 运算 失败 
return false; 
} else { V/ 被 除数 非 0， 则 进行 正常 的 除法 运算 
result = String.valueOf(Arith.div(firstNum, nextNum)); 
} 
} 
// 把 运算 结果 打印 到 日 志 中 
Log.d(TAG, "result=" + result); 
firstNum = result; 
nextNum = ""; 
// 返回 true 表示 运算 成 功 


return true; 


2.6 小 结 


本 章 主要 介绍 App 开发 初级 控件 的 相关 知识 , 包括 屏幕 显示 基础 (像素 、 颜色 、 分 辨 率 ) 、 
简单 布局 的 用 法 〈 基 本 视图 、 线 性 布局 、 滚 动 视图 ) 、 简 单 控件 的 用 法 (文本 视图 、 按 钮 、 图 
像 视图 、 图 像 按钮 ) 、 简 单 图 形 的 用 法 〈 状 态 列表 图 形 、 形 状 图 形 、 九 富 格 图 片 ) 。 最 后 设计 
了 一 个 实战 项 目 “ 简 单 计算 器 ”， 在 该 项 目的 App 编码 中 运用 了 前 面 介绍 的 大 部 分 简单 布局 
和 控件 ， 从 而 加 深 了 对 所 学 知识 的 理解 ， 并 初步 学 会 使 用 Log 和 Toast， 为 App 开发 培养 良好 
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的 编码 和 调试 习惯 。 
通过 本 章 的 学 习 ， 读 者 应 该 能 掌握 以 下 3 种 开发 技能 : 
(1) 在 布局 文件 中 合理 使 用 本 章 学 到 的 布局 和 控件 。 
(2) 在 代码 中 合理 调用 本 章 学 到 的 布局 和 控件 的 相关 方法 。 
(3) 学 会 制作 并 使 用 简单 的 图 形 描述 文件 ， 包 括 九宫 格 图 片 。 


第 2 章 


中 级 控件 


本 章 介绍 App 开发 常用 的 一 些 中 级 控件 及 相关 工具 ， 主 要 包括 其 他 布局 用 法 、 特 殊 按钮 
的 用 法 、 下 拉 框 与 基本 适配器 的 用 法 、 编辑 框 的 用 法 等 , 另外 介绍 四 大 组 件 之 一 的 活动 Activity 
的 基本 概念 与 常见 用 法 。 最 后 结合 本 章 所 学 的 知识 分 别 演示 了 两 个 实战 项 目 “ 房 贷 计算 器 ”和 
“登录 App” 的 设计 与 实现 。 


3.1 其 他 布局 





本 节 介绍 Android 另外 两 个 常用 的 布局 视图 ， 分 别 是 相对 布局 RelativeLayout 的 属性 说 明 
与 注意 点 、 框 架 布 局 FrameLayout 的 属性 说 明 与 注意 点 。 
3.1.1 相对 布局 RelativeLayout 
RelativeLayout 下 级 视图 的 位 置 是 相对 位 置 ， 得 有 有 具体 的 参照 物 才能 确定 最 终 位 置 。 如 果 
不 设 定 下 级 视图 的 参照 物 ， 那 么 下 级 视图 默认 显示 在 RelativeLayout 内 部 的 左上 角 。 用 于 确定 
视图 位 置 的 参照 物 分 两 种 ， 一 种 是 与 该 视图 自身 平 级 的 视图 ， 另 一 种 是 该 视图 的 上 级 视图 
(RelativeLayout) 。 与 参照 物 对 比 ， 相 对 位 置 的 属性 与 类 型 值 见 表 3-1。 
表 3-1 相对 位 置 的 属性 与 类 型 的 取 值 说 明 
XML 中 的 相对 位 置 属性 RelativeLayout 类 的 相对 位 置 相对 位 置 说 明 














layout_ toLeftOf LEFT_OF 当前 视图 在 指定 视图 的 左边 
layout_toRightOf RIGHT_OF 当前 视图 在 指定 视图 的 右边 
layout_above ABOVE 当前 视图 在 指定 视图 的 上 方 











layout_below BELOW 当前 视图 在 指定 视图 的 下 方 
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( 续 表 ) 
XML 中 的 相对 位 置 属性 RelativeLayout 类 的 相对 位 置 相对 位 置 说 明 
layout alignLeft ALIGN_ LEFT 当前 视图 与 指定 视图 的 左 侧 对 齐 
layout_alignRight ALIGN RIGHT 当前 视图 与 指定 视图 的 右 侧 对 齐 
layout alignTop ALIGN_TOP 当前 视图 与 指定 视图 的 顶部 对 齐 
layout_alignBottom ALIGN_BOTTOM 当前 视图 与 指定 视图 的 底部 对 齐 
layout_centerInParent CENTER IN_PARENT 当前 视图 在 上 级 视图 中 间 
layout_centerHorizontal CENTER_HORIZONTAL 当前 视图 在 上 级 视图 的 水 平方 向 居中 
layout_centerVertical CENTER_VERTICAL 当前 视图 在 上 级 视图 的 垂直 方向 居中 
layout_alignParentLeft ALIGN_PARENT _ LEFT 当前 视图 与 上 级 视图 的 左 侧 对 齐 
layout_alignParentRight ALIGN_PARENT_RIGHT 当前 视图 与 上 级 视图 的 右 侧 对 齐 
layout_alignParentTop ALIGN_PARENT_TOP 当前 视图 与 上 级 视图 的 顶部 对 齐 
layout alignParentBottom ALIGN_PARENT BOTTOM 当前 视图 与 上 级 视图 的 底部 对 齐 


为 了 更 好 地 理解 上 述 相对 属性 的 含义 , 接 下 来 使 用 RelativeLayout 及 其 下 级 视图 进行 布局 ， 
看 看 实际 效果 图 是 怎样 的 。 下 面 是 演示 相对 布局 的 XML 代码 : 


<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 

android:layout_width="match_parent" 

android:layout_height="500dp" > 

<Button 
android:id="(@+id/btn_center" 
style="(@style/btn_relative" 
android:layout_centerInParent="true" 
android:text=" 我 在 中 间 " /> 

<Button 
android:id="(@+id/btn_center_horizontal" 
style="(@style/btn_relative" 
android:layout_centerHorizontal="true" 
android:text-" 我 在 水 平 中 间 " 广 

<Button 
android:id="(@+id/btn_center_vertical" 
style="(@style/btn_relative" 
android:layout_centerVertical="true" 
android:tex 人 "我 在 垂直 中 间 " 广 

<Button 
android:id="(@+id/btn_parent_left" 
style="(@style/btn_relative" 
android:layout_marginTop="100dp" 
android:layout_alignParentLeft="true" 
android:text=" 我 跟 上 级 左边 对 齐 " 亡 

<Button 
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android:id="(@+id/btn_parent_top" 
style="(@style/btn_relative" 
android:layout_width="120dp" 
android:layout_alignParentTop="true" 
android:text=" 我 跟 上 级 顶部 对 齐 " 亡 

<Button 
android:id="(@+id/btn_parent right" 
style="(@style/btn_relative" 
android:layout_marginTop="100dp" 
android:layout_alignParentRight="true" 
android:text=" 我 跟 上 级 右边 对 齐 " 广 

<Button 
android:id="(@+id/btn_parent_bottom" 
style="(@style/btn_relative" 
android:layout_width="120dp" 
android:layout_alignParentBottom="true" 
android:layout_centerHorizontal="true" 
android:text=" 我 跟 上 级 底部 对 齐 " > 

<Button 
android:id="(@+id/btn_left_bottom" 
style="(@style/btn_relative" 
android:layout toLeftO 会 "@+id/btn_parent_bottomy" 
android:layout_alignTop="(@+id/btn_parent_bottom" 
android:text=" 我 在 底部 左边 " 亡 

<Button 
android:id="(@+id/btn_right_bottom" 
style="(@style/btn_relative" 
android:layout_toRightOf="(@+id/btn_parent_bottom" 
android:layout_alignBottom="(@+id/btn_parent_bottom" 
android:text=" 我 在 底部 右边 " 亡 

<Button 
android:id="(@+id/btn_above_center" 
style="(@style/btn_relative" 
android:layout_above="(@+id/btn_center" 
android:layout_alignLeft="(@+id/btn_center" 
android:tex 人 "我 在 中 间 上 面 " 广 

<Button 
android:id="(@+id/btn_below_center" 
style="(@style/btn_relative" 
android:layout_below="(@+id/btn_center" 
android:layout_alignRight="(@+id/btn_center" 
android:text=" 我 在 中 间 下 面 " 户 

</RelativeLayout> 
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上 述 布 局 文件 的 效果 如 图 3-1 所 示 ， 








RelativeLayout 的 下 级 视图 为 各 个 按 包 控件 ,按钮 上 的 。 区 
文字 说 明了 所 处 的 相对 位 置 ， 具体 的 控件 显示 方位 正 。 | 癌 3 漠 
如 XML 属性 中 描述 的 那样 。 
一 般 开发 者 在 布局 文件 中 就 定义 好 了 视图 的 相 | 本 本 地 丰 边 对 章 A 








对 位 置 ， 很 少 会 等 到 在 代码 中 定义 。 不 过 也 有 特殊 情 
况 ， 如 果 视 图 是 在 代码 中 动态 添加 的 ， 那 么 相对 位 置 
也 只 能 在 代码 中 临时 定义 。 代 码 中 定义 相对 位 置 用 到 
的 是 RelativeLayout.LayoutParams 的 addRule 方法 ， 
该 方法 的 第 一 个 参数 表示 相对 位 置 的 类 型 ， 具体 取 值 
说 明 见 表 3-1; 第 二 个 参数 表示 参照 物 视图 的 ID， 即 


我 在 中 间 上 面 


我 在 垂直 中 间 我 在 中 间 
我 在 中 间 下 面 





当前 视图 要 参照 哪个 视图 确定 自身 位 置 。 百度 名 左边。 我 级 友 gp 过 
下 面 是 在 代码 中 给 RelativeLayout 动态 添加 子 视 


图 并 指定 子 视图 相对 位 置 的 代码 片段 : 3-1 在 布局 文件 中 定义 的 相对 布局 


// 通过 代码 在 相对 布局 下 面 添加 新 视图 ，referId 代表 参考 对 象 的 编号 
private void addNewView(int firstAlign, int secondAlign, intreferId) { 
/ 创建 一 个 新 的 视图 对 象 
View v= new View(this); 
/ 把 该 视图 的 背景 设置 为 半 透 明 的 绿色 
VSetBackgroundColor(O0xaa66ff66); 
/ 声明 一 个 布局 参数 ， 其 中 宽度 为 100p， 高 度 也 为 100dp 
RelativeLayout.LayoutParams rl_params = new RelativeLayout.LayoutParams( 
Utils.dip2px(this, 100), Utils.dip2px(this, 100)); 
/ 给 布局 参数 添加 第 一 个 相对 位 置 的 规则 ，firstAlign 代表 位 置 类 型 ，referId 代表 参考 对 象 
rl_params.addRule(firstAlign, referId); 
if (secondAlign >= 0) { 
// 如 果 存 在 第 二 个 相对 位 置 ， 则 同时 给 布局 参数 添加 第 二 个 相对 位 置 的 规则 
TlL_params.addRule(secondAlign, referId); 
/ 给 该 视图 设置 布局 参数 
VsetLayoutParams(rl_params); 
/ 设置 该 视图 的 长 按 监听 器 
Vv.setOnLongClickListener(new OnLongClickListener() { 
// 在 用 户 长 按 该 视图 时 触发 
public boolean onLongClick(View vv) { 
/ 一 旦 监听 到 长 按 事件 ， 就 从 相对 布局 中 删除 该 视图 
TL_contentremoveView(vv); 
Teturn true; 
D); 
// 往 相 对 布局 中 添加 该 视图 
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rt content.addView(v); 
E 
动态 添加 子 控件 的 效果 如 图 3-2 所 示 , 在 图 上 给 每 个 方块 子 视图 做 了 编号 ,以 此 区 分 该 方 
块 是 由 哪个 按钮 添加 的 以 及 添加 的 相对 位 置 。 


Middle 


活 加 左边 视图 
添加 上 方 视图 
添加 右边 视图 


添加 下 方 视图 


Pn 

添加 上 挨 寺 出 对 齐 视图 
添加 上 级 项 部 对 齐 视图 
添加 上 级 右 侧 对 齐 视图 
添加 上 级 底部 对 齐 视图 





图 3-2 在 代码 中 动态 添加 下 级 视图 的 相对 布局 
3.1.2 ”框架 布局 FrameLayout 


FrameLayout 也 是 较 常 用 的 布局 ， 其 下 级 视图 无 法 指定 所 处 的 位 置 ， 只 能 统统 从 上 级 
FrameLayout 的 左上 角 开 始 添加 ， 并 且 后 面 添 加 的 子 视图 会 把 之 前 的 子 视图 覆盖 掉 。 框 架 布局 
- 般 用 于 需要 重 辣 显示 的 场合 ， 比 如 绘图 、 游 戏 界面 等 ， 常 见 属性 说 明 如 下 。 


。 foreground: 指定 框架 布局 的 前 景 图 像 . 该 图 像 在 框架 内 部 永远 处 于 最 顶层 ,不 会 被 框 
架 内 的 其 他 视图 覆盖 。 
eforegroundGravity: 指定 前 景 图 像 的 对 齐 方式 。 该 属性 的 取 值 说 明 同 gravity。 


为 了 更 直观 地 理解 FrameLayout， 可 在 代码 中 为 框架 布局 动态 添加 子 视图 ， 然 后 观察 前 后 
两 个 子 视图 的 显示 效果 。 

先 给 框架 布局 添加 一 个 暗 灰色 的 子 视图 , 如 图 3-3 所 示 。 再 给 框架 布局 添加 一 个 鲜红 色 子 
视图 ， 如 图 3-4 所 示 。 此 时 后 面 添加 的 视图 会 覆盖 前 面 添加 的 视图 。 注 意 ， 框 架 视图 上 方正 中 
间 的 小 图 标 一 直 都 没 被 覆盖 ， 是 它 被 指定 为 前 景 图 像 的 缘故 。 

除了 线性 布局 、 相 对 布局 、 框 架 布 局 外 ，Android 还 提供 了 其 他 几 个 布局 视图 ， 如 绝对 布 
局 AbsoluteLayout、 表 格 布局 TableLayout 等 ， 不 过 这 几 个 布局 在 实际 开发 中 用 得 并 不 多 ， 读 
者 只 需 掌 握 前 3 种 布局 就 可 以 了 。 
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给 下 方 的 帧 布局 添加 视图 给 下 方 的 帧 布局 添加 视图 








图 3-3 在 框架 布局 中 添加 第 一 个 子 视图 图 3-4 在 框架 布局 中 添加 第 二 个 子 视图 


3.2 ”特殊 按钮 


本 节 介 绍 几 个 常用 的 特殊 控制 按钮 ,包括 复 选 框 CheckBox 的 监听 器 用 法 、 开 关 按 钮 Switch 
的 属性 定义 、 仿 iOS 开关 按钮 的 实现 、 单 选 按钮 RadioButton 及 其 组 布局 RadioGroup 的 监听 
器 用 法 ， 以 及 如 何 更 换 这 些 控件 的 按钮 图 标 。 


3.2.1 复 选 框 CheckBox 


在 学 习 复 选 框 之 前 ， 先 了 解 一 下 CompoundButton。 在 Android 体系 中 ，CompoundButton 
类 是 抽象 的 复合 按钮 , 因为 是 抽象 类 , 所 以 不 能 直接 使 用 。 实 际 开发 中 用 的 是 CompoundButton 
类 的 几 个 派生 类 ， 主 要 有 复 选 框 CheckBox、 单 选 按钮 RadioButton 以 及 开关 按钮 Switch， 这 
些 派生 类 都 可 使 用 CompoundButton 的 属性 和 方法 。 

CompoundButton 在 布局 文件 中 主要 使 用 下 面 两 个 属性 。 


e checked: 指定 按钮 的 勾 选 状态 ，true 表示 勾 选 ，false 表示 未 勾 选 。 默 认 未 勾 选 。 
。 button: 指定 左 侧 勾 选 图 标的 图 形 。 如 果 不 指定 就 使 用 系统 的 默认 图 标 。 


CompoundButton 在 代码 中 可 使 用 下 列 4 种 方法 进行 设置 。 


setChecked: 设置 按钮 的 勾 选 状态 。 
setButtonDrawable: 设置 左 侧 勾 选 图 标的 图 形 。 
setOnCheckedChangeListener: 设置 勾 选 状态 变化 的 监听 器 。 
isChecked: 判断 按钮 是 否 勾 选 。 

复 选 框 CheckBox 是 CompoundButton 一 个 最 简单 的 实现 ， 点 击 复 选 框 勾 选 ， 再 次 点 击 取 
消 勾 选 。CheckBox 通过 setOnCheckedChangeListener 方法 设置 勾 选 监 昕 器， 对 应 的 监听 器 要 
实现 接口 CompoundButton.OnCheckedChangeListener。 下 面 是 复 选 框 处 理 色 选 监听 器 的 代码 例子 : 
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public class CheckboxActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_checkbox); 
/ 从 布局 文件 中 获取 名 叫 ck_system 的 复 选 框 
CheckBox ck_system = findViewById(R.id.ck_systemy); 
/设置 色 选 监听 器 ， 一 旦 用 户 点 击 复 选 框 ， 就 触发 监听 器 的 onCheckedChanged 方法 
ck_system.setOnCheckedChangeListener(new CheckListener()); 


// 定义 一 个 色 选 监听 器 ， 它 实现 了 接口 CompoundButton.OnCheckedChangeListener 
private class CheckListener implements CompoundButton.OnCheckedChangeListener{ 
/ 在 用 户 点 击 复 选 框 时 触发 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
String desc = String.format(" 您 勾 选 了 控件 %d， 状 态 为 %b", buttonView.getId0, isChecked); 
ToastmakeText(CheckboxActivity.this, desc, Toast.LENGTH_LONG).show(); 


} 
要 更 换 复 选 框 左 侧 的 勾 选 图 像 ， 可 将 button 属性 修改 为 自 定义 的 勾 选 图 形 。 下 面 是 一 个 
勾 选 图 形状 态 定 义 的 例子 ， 如 果 是 勾 选 状态 ,就 显示 图 形 check_choose; 如 果 取 消 勾 选 ， 就 显 
示 图 形 check_unchoose。 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:state_checked="true" android:drawable="(@drawable/check_choose"/> 


<item android:drawable="(@drawable/check_unchoose"/> 
</selector> 


3.2.2 ”开关 按钮 Switch 


Switch 是 开关 按钮 ，Android 从 4.0 版 本 开始 支持 该 控件 。 其 实 Switch 是 一 个 高 级 版 本 的 
CheckBox, 在 选中 与 取消 选中 时 可 展现 的 界面 元 素 比 CheckBox 丰富 。Switch 新 添加 的 属性 和 
设置 方法 见 表 3-2。 


表 3-2 ”Switch 控件 的 属性 和 设置 方法 说 明 





XML 中 的 属性 Switch 类 的 设置 方法 | 说 明 





textOn setTextOn 设置 右 侧 开启 时 的 文本 

textOff setTextOff 设置 左 侧 关 闭 时 的 文本 

switchPadding setSwitchPadding 设置 左右 两 个 开关 按钮 之 间 的 距离 

thumbTextPadding | setThumbTextPadding | 设置 文本 左右 两 边 的 距离 。 如 果 设 置 了 该 属性 ，switchPadding 
属性 就 会 失效 
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( 续 表 ) 
XML 中 的 属性 Switch 类 的 设置 方法 | 说 明 
thumb setThumbDrawable 设置 开关 轨道 的 背景 
setThumbResource 
track setTrackDrawable 设置 开关 标识 的 图 标 
setTrackResource 








Switch 是 升级 版 的 CheckBox， 实际 开发 中 用 得 不 多 。 原 因 之 一 是 大 家 觉得 Switch 的 默认 
界面 很 及， 如 图 3-5 和 图 3-6 所 示 ， 方 方正 正 的 图 标 有 点 土 又 有 点 呆板 ; 原因 之 二 是 iPhone 
作为 高 大 上 手机 的 代表 ， 大 家 都 觉得 iOS 的 UI 很 漂亮 ， 于 是 无 论 是 用 户 还 是 客户 ， 都 希望 
App 做 得 与 iOS 控件 相像 ，iOS 的 开关 按钮 UISwitch 就 成 了 大 家 仿照 的 对 象 。 


Middle Middle 


Switch 开关 : Switch 开关 : 


Switch 按钮 的 状态 是 关 Switch 技 钮 的 状态 是 开 





图 3-5 Switch 控件 的 “ 关 ” 状 态 图 3-6 Switch 控件 的 “ 开 ” 状 态 


现在 我 们 要 让 Android 实现 类 似 iOS 的 开关 按钮 ， 主 要 思路 是 借助 状态 列表 图 形 
StateListDrawable， 首 先 定义 一 个 状态 列表 ，XML 的 代码 如 下 : 
<selector xmilns:android="http://schemas.android.com/apk/res/android"> 
<item android:state_checked="true" android:drawable="(@drawable/switch_on"/> 
<item android:drawable="(@drawable/switch_off"/> 
</selector> 


然后 把 CheckBox 控件 的 background 属性 设置 为 该 状态 图 形 ， 当 然 button 属性 要 先 设置 
为 @null。 为 什么 这 里 修改 background 属性 ,而 不 直接 修改 button 属性 呢 ? 因为 button 属性 是 
有 限制 的 , 无 论 多 大 的 图 片 ,都 只 显示 一 个 小 小 的 图 标 ,可 是 小 小 的 图 标 怎么 能 体现 用 户 高 大 
上 的 身份 呢 ? 所 以 这 里 必须 使 用 background， 要 它 有 多 大 就 能 有 多 大 ， 这 才 够 炫 、 够 档次 。 

最 后 看 看 这 个 仿 iOS 开关 按钮 的 效果 ， 如 图 3-7 和 图 3-8 所 示 。 这 下 开关 按钮 脱胎 换 骨 ， 
又 圆 又 鲜艳 ， 看 起 来 好 看 很 多 。 





仿 i0S 的 开关 : 仿 i0S 的 开关 : ©@ 





仿 iOS 开 关 的 状态 是 关 仿 i0S 开 关 的 状态 是 开 
图 3-7 仿 iOS 按钮 的 “ 关 ” 状 态 3-8 仿 iOS 按钮 的 “ 开 ” 状 态 


3.2.3 ” 单 选 按钮 RadioButton 
单 选 按钮 要 在 一 组 按钮 中 选择 其 中 一 项 ， 并 且 不 能 多 选 ， 这 要 求 有 个 容器 确定 这 组 按钮 
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的 范围 ， 这 个 容器 便 是 RadioGroup。RadioGroup 实质 上 是 个 布局 ,同一 组 RadioButton 都 要 放 

在 同一 个 RadioGroup 节点 下 。RadioGroup 有 orientation 属性 可 指定 下 级 控件 的 排列 方向 ， 该 

属性 为 horizontal 时 ， 单 选 按钮 在 水 平方 向 排列 ， 该 属性 为 vertical 时 ， 单 选 按钮 在 垂直 方向 

排列 。RadioGroup 下 面 除了 RadioButton， 还 可 以 挂 载 其 他 子 控件 (如 TextView、ImageView 

等 ) 。 这 样 看 来 ，RadioGroup 就 是 一 个 特殊 的 线性 布局 ， 只 不 过 多 了 管理 单 选 按 钮 的 功能 。 
下 面 是 RadioGroup 常用 的 3 个 方法 。 


e@ check: 选中 指定 资源 编号 的 单 选 按钮 。 
。 getCheckedRadioButtonId: 获取 选中 状态 单 选 按钮 的 资源 编号 。 
e@ setOnCheckedChangeListener: 设置 单 选 按钮 勾 选 变化 的 监听 器 。 


RadioButton 默认 未 选中 ， 点 击 后 显示 选中 ， 但 是 再 次 点 击 不 会 取消 选中 。 只 有 点 击 同 组 
的 其 他 单 选 按钮 时 ， 原 来 选中 的 单 选 按钮 才 会 取消 选中 。 另 外 , 单 选 按钮 的 选中 事件 一 般 不 由 
RadioButton 处 理 ， 而 是 由 RadioGroup 响应 。 选 中 事件 在 实现 时 ， 首 先 要 写 一 个 单 选 监 听 器 实 
现 接口 RadioGroup.OnCheckedChangeListener ， 然后 调用 RadioGroup 对 象 的 
setOnCheckedChangeListener 方法 注册 该 监听 器 。 

下 面 是 用 RadioGroup 实现 单 选 监 听 器 的 代码 : 


public class RadioHorizontalActivity extends AppCompatActivity {// 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_radio_horizontal); 
// 从 布局 文件 中 获取 名 叫 rg_sex 的 单 选 组 
RadioGroup rg_sex = findViewById(R.id.rg_sex); 
/ 设置 单 选 监听 器 ， 一 旦 用 户 点 击 组 内 的 单 选 按钮 ， 就 触发 监听 器 的 onCheckedChanged 方法 
rg_sex.setOnCheckedChangeListener(new RadioListener()); 


1 


// 定义 一 个 单 选 监听 器 ， 它 实现 了 接口 RadioGroup.OnCheckedChangeListener 
class RadioListener implements RadioGroup.OnCheckedChangeListener{ 
/ 在 用 户 点 击 组 内 的 单 选 按钮 时 触发 
public void onCheckedChanged(RadioGroup group, int checkedId) { 
Toast.makeText(RadioHorizontalActivity.this, "您 选中 了 控件 "+checkedId， 
ToastLENGTH LONG).show0: 
} 
} 


RadioButton 经 常会 更 换 按钮 图 标 ， 如 果 通 过 button 属性 变更 图 标 ， 那 么 图 标 与 文字 就 会 
挨 得 很 近 ， 如 图 3-9 所 示 的 第 一 个 单 选 按钮 。 为 了 拉 开 图 标 与 文字 之 间 的 距离 ， 得 换 成 
drawableLeft 属性 展示 新 图 标 〈 不 要 忘 了 把 button 改 为 @null) ， 此 时 再 设置 drawablePadding 
即 可 指定 间隔 距离 。 修 改 后 的 单 选 按钮 效果 如 图 3-10 所 示 ， 可 以 看 到 图 标 与 文字 之 间 的 距离 
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Middle 


请 选择 您 的 婚姻 状况 请 选择 您 的 婚姻 状况 


@ 〇 9 示 婚 未 婚 
已 婚 © Bs 
哇 哦 ， 你 的 前 途 不 可 限量 哇 哦 ， 祝 你 早生 贵子 





图 3-9 图 标 设置 在 button 属性 上 图 3-10 图 标 设置 在 drawableLeft 属性 上 


前 面 给 不 同 的 按钮 自 定义 按钮 图 标 先 后 用 了 3 个 属性 , 即 自 定义 CheckBox 图 标 时 的 button 
属性 、 仿 iOS 开关 按钮 时 的 background 属性 以 及 自 定义 RadioButton 时 的 drawableLeft 属性 。 
下 面 总 结 一 下 这 3 个 图 标 设置 方式 分 别 适 用 的 场合 。 


e@ button: 主要 用 于 图 标 大 小 要 求 不 高 ， 间 隔 要 求 也 不 高 的 场合 。 
e@ background: 主要 用 于 能 够 以 较 大 空间 显示 图 标的 场合 。 
e@ drawableLeft: 主要 用 于 对 图 标 与 文字 之 间 的 间隔 有 要 求 的 场合 。 


3.3 ” 适 配 视 图 基础 


本 节 介 绍 适 配器 的 基本 概念 ， 结 合 对 下 拉 框 Spinner 的 使 用 说 明 分 别 阐述 数组 适配器 
ArrayAdapter、 简 单 适配器 SimpleAdapter 的 具体 用 法 与 展示 效果 。 


3.3.1 下 拉 框 Spinner 


Spinner 是 下 拉 框 ， 用 于 从 一 串 列表 中 选择 某 项 ， 功 能 类 似 于 单 选 按钮 的 组 合 。 下 拉 列 表 
的 展示 方式 有 两 种 ， 一 种 是 在 当前 下 拉 框 的 正 下 方 展示 列表 ， 此 时 把 spinnerMode 属性 设置 为 
dropdown; 另 一 种 是 在 页 面 中 部 以 对 话 框 形式 展示 列表 ， 此 时 把 spinnerMode 属性 设置 为 
dialog。 另 外 ，Spinner 还 可 以 在 代码 中 调用 下 列 4 个 方法 。 


setPrompt: 设置 标题 文字 。 

setAdapter: 设置 下 拉 列 表 的 适配器 。 适 配器 可 选择 ArrayAdapter 或 SimpleAdapter。 
setSelection: 设置 当前 选中 哪 项 。 注 意 该 方法 要 在 setAdapter 方法 后 调用 。 
setOnltemSelectedListener: 设置 下 拉 列 表 的 选择 监听 器 ， 该 监听 器 要 实现 接口 
OnltemSelectedListener. 


下 面 是 一 个 下 拉 框 调用 选择 监听 器 的 代码 例子 : 


/ 初始 化 下 拉 框 
private void initSpinner() { 
/ 声明 一 个 下 拉 列 表 的 数组 适配器 
ArrayAdapter<String> starAdapter = new ArrayAdapter<String>(this, 
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R.layout.item select starArray); 
/ 设置 数组 适配器 的 布局 样式 
starA dapter.setDropDownViewResource(R.layout.item_dropdown); 
// 从 布局 文件 中 获取 名 叫 sp_dialog 的 下 拉 框 
Spinner sp =findViewById(R.id.sp_dialog); 
/ 设置 下 拉 框 的 标题 
sp.setPrompt(" 请 选择 行星 "); 
/ 设置 下 拉 框 的 数组 适配器 
sp.setAdapter(starAdapter); 
/ 设置 下 拉 框 默认 显示 第 一 项 
sp.setSelection(0); 
/ 给 下 拉 框 设置 选择 监听 器 ， 一 旦 用 户 选中 某 一 项 ， 就 触发 监听 器 的 onItemSelected 方法 
sp.setOnltemSelectedListener(new MySelectedListener()); 
b 


// 定义 下 拉 列 表 需 要 显示 的 文本 数组 

private String[] starArray = {" 水 星 ", "金星 ", "地 球 ", "火星 ", "木星 ", "土星 "}; 
/ 定义 一 个 选择 监听 器 ， 它 实现 了 接口 OnItemSelectedListener 

class MySelectedListener implements OnItemSelectedListener { 


/ 选择 事件 的 处 理 方法 ， 其 中 arg2 代表 选择 项 的 序号 
public void onltemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
Toast.makeText(SpinnerDialogActivity.this, "您 选择 的 是 " + starArray[arg2], 
Toast LENGTH _LONG).show0; 


} 


/ 未 选择 时 的 处 理 方法 ， 通 常 无 需 关注 
public void onNothingSelected(AdapterView<?> arg0) {} 
出 


接 下 来 看 对 话 框 模式 的 下 拉 效 果 ， 如 图 3-11 所 示 。 页 面 中 
部 弹出 六 大 行星 的 下 拉 列 表 ; 点 击 具体 行星 项 后 自动 收 起 下 拉 
列表 ， 并 且 下 拉 框 中 的 文字 变更 为 刚 选中 的 行星 名 称 。 
3.3.2 ”数组 适配器 ArrayAdapter 


前 面 在 演示 Spinner 时 用 到 了 setAdapter 方法 设置 适配器 。 
这 个 适配器 好 比 一 组 数据 的 加 工 流水 线 , 你 丢 给 它 一 大 把 糖果 ， 
适配器 把 糖果 排列 好 顺序 ， 然 后 拿 来 制作 好 的 包装 盒 ， 把 糖果 
往 里 面 一 塞 ， 出 来 的 便 是 一 个 个 精美 的 糖果 盒 。 这 个 流水 线 可 
以 做 得 很 复杂 ， 也 可 以 做 得 简单 一 些 ， 最 简单 的 流水 线 就 是 之 
前 演示 Spinner 用 到 的 ArrayAdapter。 _ _ 

ArrayAdapter 主要 用 于 每 行列 表 只 展示 文本 的 情况 ， 有 两 “图 3-11 dialog 模式 的 下 拉 列 表 
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道 工序 ， 第 一 道 工序 是 构造 函数 ， 除 了 提供 一 堆 原始 数据 外 (六 大 行星 的 名 称 列表 ) ， 还 可 以 
指定 下 拉 框 当前 文本 的 包装 盒 ， 即 下 面 这 行 代码 里 的 R.layout.item_select， 这 个 布局 文件 内 只 
有 一 个 TextView， 定 义 了 当前 选中 文本 的 大 小 、 颜 色 、 对 齐 方式 等 属性 。 

/ 声明 一 个 下 拉 列 表 的 数组 适配器 

ArrayAdapter<String> starAdapter =new ArrayAdapter<String>(this, R.layout.item_select, starArray); 


第 二 道 工 序 是 定义 下 拉 列 表 的 包装 盒 ， 即 下 面 代 码 里 的 R.layout.item dropdown， 定 义 了 
对 话 框 列表 中 每 行文 本 的 显示 属性 。 
/ 设置 数组 适配器 的 布局 样式 
starAdapter.setDropDownViewResource(R.layout.item_dropdown); 


经 过 这 两 道 工序 ，ArrayAdapter 就 明确 了 原料 糖果 的 分 拣 过程 与 包装 方式 ， 接 下 来 只 待 
Spinner 调用 setAdapter 方法 发 出 开动 机 器 指令 ， 适 配器 便 会 把 一 个 一 个 包装 好 的 糖果 盒 输出 到 
屏幕 界面 。 


3.3.3 简单 适配器 SimpleAdapter 


ArrayAdapter 只 能 显示 文本 列表 ， 显 然 不 够 美观 ， 有 时 我 们 还 想 给 列表 加 上 图 标 ， 比 如 六 
大 行星 是 否 分 别 显示 星球 的 小 图 。 这 时 SimpleAdapter 就 派 上 用 场 了 ， 它 允许 在 列表 项 中 展示 
多 个 控件 ， 包 括 文本 与 图 片 。 
SimpleAdapter 的 实现 略微 复杂 ， 除 了 第 二 道 工序 与 ArrayAdapter 一 样 外 ， 第 一 道 工 序 需 
要 更 多 信息 。 例 如 ， 原 料 不 但 有 糖果 , 还 有 贺卡 ， 这 样 就 得 把 一 大 袋 糖 果 和 一 大 袋 贺 卡 送 进 流 
水 线 ， 适 配器 每 次 拿 一 颗 糖 果 和 一 张 锅 卡 ， 把 糖果 与 贺卡 按 规 定 塞 进 包 装 盒 。 对 于 
SimpleAdapter 的 构造 函数 来 说 ， 第 二 个 参数 Map 容器 放 的 是 原料 糖果 与 贺卡 ， 第 3 个 参数 放 
的 是 包装 盒 , 第 4 个 参数 放 的 是 糖果 袋 与 贺卡 袋 的 名 称 , 第 5 个 参数 放 的 是 包装 盒 里 塞 糖果 的 
位 置 与 塞 贺 卡 的 位 置 。 
下 面 是 下 拉 框 Spinner 使 用 SimpleAdapter 的 示例 代码 : 
/ 初始 化 下 拉 框 ， 演 示 简单 适配器 
private void initSpinnerForSimpleAdapter0 { 
/ 声明 一 个 映射 对 象 的 队列 ， 用 于 保存 行星 的 图 标 与 名 称 配对 信息 
List<Map<String, Object>> list = new ArrayList<Map<String, Object>>(); 
/iconArray 是 行星 的 图 标 数组 ，starArray 是 行星 的 名 称 数组 
for (inti= 0; i< iconArray.length; i++) { 
Map<String, Object> item = new Hash Map<String, Object>(); 
item.put("icon", iconArray[i]); 
item.put("name", starArray[i]); 
// 把 一 个 行星 图 标 与 名 称 的 配对 映射 添加 到 队列 当中 
list.add(item); 
} 
/ 声明 一 个 下 拉 列 表 的 简单 适配器 ， 其 中 指定 了 图 标 与 文本 两 组 数据 
SimpleAdapter starAdapter = new SimpleAdapter(this, list, 
R.layout.item simple, new String[]{"icon", "name"}, 
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new int[]{R.id.iv_icon, R.id.tvy_name}); 

/ 设置 简单 适配器 的 布局 样式 

starAdapter.setDropDownViewResource(R.layout.item_simple); 

/ 从 布局 文件 中 获取 名 叫 sp_icon 的 下 拉 框 

Spinner sp =findViewById(R.id.sp_icon); 

/ 设置 下 拉 框 的 标题 

sp.setPrompt(" 请 选择 行星 "); 

/ 设置 下 拉 框 的 简单 适配器 

sp.setAdapter(starAdapter); 

/ 设置 下 拉 框 默认 显示 第 一 项 

sp.setSelection(0); 

/ 给 下 拉 框 设置 选择 监听 器 ， 一 旦 用 户 选中 某 一 项 ， 就 触发 监听 器 的 onItemSelected 方法 

sp.setOnltemSelectedListener(new MySelectedListener()); 
| 

下 面 是 每 个 列表 项 的 布局 文件 内 容 〈 包 装 盒 ) : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:orientation="horizontal" > 


<!-- 这 是 展示 行星 图 标的 ImageView --> 
<ImageView 
android:id="(@+id/iv_icon" 
android:layout_width="0dp" 
android:layout_height="50dp" 
android:layout_weight="1" 
android:gravity="center" /> 


<!-- 这 是 展示 行星 名 称 的 TextView -> 

<TextView 
android:id="(@+id/tv_name" 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="3" 
android:gravity="center" 
android:textSize="17sp" 
android:textColor="#ff0000" /> 

</LinearLayout> 


斋 了 这 么 多 代码 ， 下 面 看 一 下 加 了 图 标的 下 拉 列 表 的 效 
果 图 ， 如 图 3-12 所 示 。 此 时 下 拉 列 表 左 边 显示 行星 的 图 片 
右边 显示 行星 的 名 称 。 





3-12 带 图 标的 下 拉 列 表 
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3.4 编辑 框 


本 节 介 绍 Android 的 两 种 编辑 框 ， 分 别 是 文本 编辑 框 EditText 与 自动 完成 编辑 框 
AutoCompleteTextView。 在 介绍 EditText 控件 时 ， 除 了 基本 属性 和 方法 ， 还 另外 阐述 了 常见 的 
4 种 编辑 处 理 : 更 换 光 标 、 更 换 边框 、 自 动 隐藏 输入 法 和 输入 回 车 符 自动 换行 。 

3.4.1 文本 编辑 框 EditText 
EditText 是 文本 编辑 框 ， 用 户 可 在 此 输入 文本 等 信息 。EditText 的 常用 属性 说 明 如 下 。 
e inputType: 指定 输入 的 文本 类 型 ， 代 码 中 对 应 的 方法 是 setInputType。 输 入 类 型 的 取 
值 说 明 见 表 3-3， 若 同时 使 用 多 种 文本 类 型 ， 则 可 使 用 竖 线 “|” 把 多 种 文本 类 型 拼接 
起 来 。 

e maxLength: 指定 文本 允许 输入 的 最 大 长 度 。 该 属性 无 法 通过 代码 设置 。 

e hint: 指定 提示 文本 的 内 容 ， 代 码 中 对 应 的 方法 是 setHint。 

@ textColorHint: 指定 提示 文本 的 颜色 ， 代 码 中 对 应 的 方法 是 setHintTextColor。 

表 3-3 输入 类 型 的 取 值 说 明 

















输入 类 型 说 明 

text 文本 

textPassword 文本 密码 。 显 示 时 用 星 号 “* ”代替 

number 整 型 数 

numberSigned 带 符号 的 数字 。 人 允许 在 开头 带 负 号 “一 ” 

numberDecimal 带 小 数 点 的 数字 

numberPassword 数字 密码 。 显 示 时 用 星 号 “*” 代 替 

datetime 时 间 日 期 格式 。 除 了 数字 外 ， 还 允许 输入 横 线 、 斜 杆 、 空 格 、 冒 号 
date 日 期 格式 。 除 了 数字 外 ， 还 允许 输入 横 线 “-” 和 和 斜 杆 “/” 

time 时 间 格 式 。 除 了 数字 外 ， 还 允许 输入 冒号 “:” 


编辑 框 除 了 上 述 文 本 与 提示 文本 的 基本 操作 外 ， 实 际 开发 中 还 常常 关注 4 个 方面 : 更 换 
编辑 框 的 光标 、 更 换 编辑 框 的 边框 、 自 动 隐藏 输入 法 、 输 入 回 车 符 自动 跳 转 。 

1. 更 换 编 辑 框 的 光标 

EditText 与 光标 处 理 有 关 的 属性 主要 有 两 个 ， 分 别 是 : 

e@ cursorVisible， 指 定 光 标 是 否 可 见 。 代 码 中 对 应 的 方法 是 setCursorVisible。 

e textCursorDrawable， 指 定 光标 的 图 像 。 该 属性 无 法 通过 代码 设置 。 


如 果 要 隐藏 光标 ， 就 要 把 cursorVisible 设置 为 false。 如 果 要 变更 光标 的 样式 ， 就 要 修改 
textCursorDrawable 设置 新 图 像 。 如 图 3-13 所 示 ， 光 标 被 换 成 自 定义 的 红色 竖 线 光 标 。 
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2. 更 换 编辑 框 的 边框 


EditText 的 边框 通过 background 属性 控制 ， 如 果 要 隐藏 边 框 ， 就 要 把 background 设置 为 
@null; 如 果 要 修改 边框 的 样式 ， 就 要 将 background 设置 为 其 他 边框 图 形 。 
下 面 是 一 个 边框 定义 XML 的 例子 ， 一 旦 编辑 框 获 得 焦点 (例如 用 户 点 击 了 该 编辑 框 〉， 
边框 就 会 显示 图 形 shape_edit_focus; 否则 默认 显示 shape_edit_normal。 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:state focused="true" android:drawable="(@drawable/shape_edit focus"/> 
<item android:drawable="@drawable/shape_edit_normal"/> 
</selector> 


上 述 自 定义 边框 的 效果 如 图 3-14 所 示 ， 未 点 击 时 显示 灰色 的 圆 角 边框 ， 点 击 后 显示 蓝 色 
的 圆 角 边框 。 





Middle 


这 是 默认 边框 


我 的 边框 不 见 了 
我 的 边框 是 圆 角 








3-13 给 EditText 更 换 图 标 样式 图 3-14 给 EditText 更 换 边 框 样式 
3. 自动 隐藏 输入 法 


如 果 页 面 上 有 EditText 控件 ， 开 发 者 又 没 做 其 他 处 理 ， 那 么 用 户 打开 该 页 面 时 往往 会 自 
动弹 出 输入 法 。 这 是 因为 编辑 框 会 默认 获得 焦点 ， 即 默认 模拟 用 户 的 点 击 操作 ,于 是 输入 法 的 
软 键盘 就 弹出 了 。 要 想 避 免 这 种 情况 ， 就 得 阻止 编辑 框 默认 获得 焦点 。 比 较 常 见 的 做 法 是 给 该 
页 面 的 根 节点 设置 focusable 和 focusableInTouchMode 属性 ， 通 过 将 这 两 个 属性 设置 为 true 可 
强制 让 根 节点 获得 焦点 ， 从 而 避免 输入 法 自动 弹出 的 尴 粹 。 

由 于 软 键盘 通常 会 遮盖 “登录 ”“ 确 认 ”“ 下 一 步 ” 等 按钮 ， 造 成 用 户 输入 完毕 得 再 点 

-次 返回 键 才能 关闭 软 键盘 。 大 家 都 希望 省 事 点 ， 比 如 手机 号 输入 满 11 位 软 键 盘 自 动 关闭 ， 
这 样 就 会 极 大 改善 用 户 体 验 。 一 个 好 用 的 App 就 是 在 这 一 点 一 滴 中 体现 出 来 的 。 

想 让 编辑 框 文本 达到 指定 长 度 时 自动 关闭 输入 法 ， 开 发 者 需要 获得 两 个 参数 ， 第 一 个 是 
该 编辑 框 允许 输入 的 最 大 长 度 , 第 二 个 是 当前 已 经 输入 的 文本 长 度 。 当 已 输入 的 文本 长 度 等 于 
最 大 长 度 时 ， 即 可 触发 关闭 软 键盘 。 自动 隐藏 输入 法 可 分 解 为 3 个 功能 点 , 分 别 是 获取 编辑 框 
的 最 大 长 度 、 监 控 当 前 已 输入 的 文本 长 度 和 关闭 软 键 盘 。 


(1) 获取 编辑 框 的 最 大 长 度 

前 面 提 到 maxLength 属性 可 设置 最 大 长 度 ， 但 是 EditText 并 没有 直接 提供 获取 最 大 长 度 
的 方法 , 不 过 开发 者 可 以 通过 反射 方式 间接 获得 最 大 长 度 , 具体 代码 参见 本 书 附带 源码 middle 
模块 里 面 ViewUtiljava 的 getMaxLength 方法 。 

(2 ) 监控 当前 已 输入 的 文本 长 度 

这 个 监控 操作 用 到 一 个 文本 监听 器 接口 TextWatcher， 该 接口 提供 了 3 个 监控 方法 ， 具 体 
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说 明 如 下 。 


@ ”beforeTextChanged: 在 文本 改变 之 前 触发 。 
@ onTextChanged: 在 文本 改变 过 程 中 触发 。 
@ afterTextChanged: 在 文本 改变 之 后 触发 。 


这 里 用 到 的 是 afterTextChanged 方法 , 开发 者 需要 自己 写 个 监听 器 实现 TextWatcher 接口 ， 
另外 再 给 EditText 对 象 调用 addTextChangedListener 方法 注册 该 监听 器 。 下 面 是 一 个 具体 实现 
该 监听 器 的 例子 ， 用 途 是 在 输入 文本 达到 指定 长 度 时 自动 隐藏 输入 法 : 


// 定义 一 个 编辑 框 监听 器 ， 在 输入 文本 达到 指定 长 度 时 自动 隐藏 输入 法 
private class HideTextWatcher implements TextWatcher { 

private EditText mView; / 声明 一 个 编辑 框 对 象 

private int mMaxLength; / 声明 一 个 最 大 长 度 变 量 

private CharSequence mStr;// 声明 一 个 文本 串 


public HideTextWatcher(EditText v) { 
super(); 
mView = V; 
/ 通过 反射 机 制 获取 编辑 框 的 最 大 长 度 
mMaxLength = ViewUtil.getMaxLength(V); 
} 


/ 在 编辑 框 的 输入 文本 变化 前 触发 
public void beforeTextChanged(CharSequence s, int start, int count, int after) {} 


/ 在 编辑 框 的 输入 文本 变化 时 触发 
public void onTextChanged(CharSequence s, int start, int before, int count) { 
mStr = s; 
; 
/ 在 编辑 框 的 输入 文本 变化 后 触发 
public void afterTextChanged(Editable s) { 
if (mStr — null || mStr.length| 一 0) 
return; 
// 输入 文本 达到 11 位 (如 手机 号 码 ) 时 关闭 输入 法 
if (mStr.length() 一 11 && mMaxLength 一 11) { 
ViewUtil.hideAllInputMethod(EditHideActivity.this); 
} 
/ 输入 文本 达到 6 位 (如 登录 密码 ) 时 关闭 输入 法 
if (mStr.length() — 6 && mMaxLength == 6) { 
ViewUtil.hideOneInputMethod(EditHideActivity.this, mView); 
}; 
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(3 ) 关闭 软 键盘 
输入 法 通过 系统 服务 INPUT_METHOD SERVICE 管理 , 所 以 隐藏 输入 法 也 要 通过 该 服务 
实现 。 下 面 是 关闭 软 键盘 的 两 种 方式 及 其 代码 ; 


@ 调用 toggleSoftInput 方法 : 


public static void hideAllInput Method(Activity acb { 
/ 从 系统 服务 中 获取 输入 法 管理 器 
InputMethodManager imm = (InputMethodManager) 
act.getSystemService(Context.INPUT METHOD SERVICE); 
让 (imm.isActive0) { // 软 键盘 如 果 已 经 打开 则 关闭 之 
imm.toggleSoftInput(0, InputMethodManagerHIDE NOT_ALWAYS); 
} 
} 


@ 调用 hideSoftInputFromWindow 方法 : 


public static void hideOneInputMethod(Activity act, View v) { 
/ 从 系统 服务 中 获取 输入 法 管理 器 
InputMethodManager imm = (InputMethodManager) 
actgetSystemService(ContextINPUT METHOD_SERVICE); 
/ 关闭 屏幕 上 的 输入 法 软 键盘 
imm.hideSoftInputFromWindow(v.getWindowToken(), 0); 
| 


完成 隐藏 输入 法 的 编码 后 ， 可 在 页 面 上 观察 效果 ， 如 图 3-15 所 示 。 此 时 手机 号 码 输入 了 
10 位 , 还 没 达到 11 位 的 最 大 长 度 ， 故 而 输入 法 依然 显示 。 手机 号 再 输入 一 位 数字 ， 总 长 度 11 
位 达到 最 大 长 度 的 限制 ， 于 是 输入 法 自动 隐藏 ， 如 图 3-16 所 示 。 


Middle Middle 





图 3-15 输入 10 位 手机 号 码 图 3-16 输入 11 位 手机 号 码 
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4. 输入 回 车 符 自动 跳 转 


在 录入 用 户 信息 时 《比如 输入 姓名 、 密 码 等 ) ， 往 EditText 控件 输入 回 车 键 ， 常 常 不 是 
换行 而 是 让 光标 直接 跳 到 下 一 个 编辑 框 。 该 功能 也 用 到 了 文本 监听 器 接口 TextWatcher， 主 要 























监听 用 户 是 否 输入 回 车 符 ， 如 果 监 控 到 已 输入 回 车 符 ， 就 自动 将 焦点 移 到 下 一 个 控件 ， 从 而 实 
现 回 车 符 自动 跳 转 的 要 求 。 
下 面 是 一 个 回 车 符 监 听 器 的 代码 例子 ， 注 意 注 释 部 分 的 文字 说 明 : 








// 定义 一 个 编辑 框 监听 器 ， 在 输入 回 车 符 时 自动 跳 到 下 一 个 控件 


Private class JumpTextWatcher implements TextWatcher { 


Private EditText mThisView; / 声明 当前 的 编辑 框 对 象 
private View mNextView; / 声明 下 一 个 视图 对 象 


public JumpTextWatcher(EditText vThis, View vNext) { 
super0; 
mThisView = vThis; 
if (vNext != null) { 
mNextView = vNext; 
} 
} 


/ 在 编辑 框 的 输入 文本 变化 前 触发 
public void beforeTextChanged(CharSequence s, int start, int count, int after) {} 


/ 在 编辑 框 的 输入 文本 变化 时 触发 
public void onTextChanged(CharSequence s, int start, int before, int count) {} 


/ 在 编辑 框 的 输入 文本 变化 后 触发 
public void afterTextChanged(Editable s) { 
String str = s.toString(); 
// 发 现 输入 回 车 符 或 换行 符 
if (str.contains("\r") || str.contains("\n")) { 
// 去 掉 回 车 符 和 换行 符 
mThisView.setText(str.replace("\r", "").replace(\nm", "")); 
if (mNextView != null) { 
// 让 下 一 个 视图 获得 焦点 ， 即 将 光标 移 到 下 个 视图 
mNextView.requestFocus(); 
// 如 果 下 一 个 视图 是 编辑 框 ， 则 将 光标 自动 移 到 编辑 框 的 文本 末尾 
if (mNextView instanceof EditText) { 
EditText et = (EditText) mNextView; 
// 让 光标 自动 移 到 编辑 框 内 部 的 文本 末尾 
// 方式 一 : 直接 调用 EditText 的 setSelection 方法 
et.setSelection(et.getText().length()); 
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// 方式 二 : 调用 Selection 类 的 setSelection 方法 
/WEditable edit = et.getText(); 
//Selection.setSelection(edit, edit.length()); 


| 
下 面 演示 一 下 输入 回 车 符 自动 跳 转 的 效果 图 ， 文 本 输入 完毕 后 还 没 输入 回 车 符 ， 此 时 焦 
点 仍然 停留 在 编辑 框 ， 如 图 3-17 所 示 。 输入 回 车 符 , 此 时 焦点 离开 编辑 框 ， 并 自动 移动 到 “ 登 
录 ” 按 钮 (编辑 框 的 光标 消失 ， 按 钮 背景 变 深 ) ， 如 图 3-18 所 示 。 








Middle Middle 








图 3-17 未 按 回 车 符 图 3-18 已 按 回 车 符 
3.4.2 ”自动 完成 编辑 框 AutoCompleteTextView 


自动 完成 编辑 框 一 般 用 于 搜索 文本 框 ， 如 在 电 商 App 的 搜索 框 输入 商品 文字 时 ， 下 方 会 
自动 弹出 提示 词 列 表 ， 方 便 用 户 快速 选择 具体 商品 。AutoCompleteTextView 的 实现 原理 是 : 
EditText 结合 监听 器 TextWatcher 与 下 拉 列 表 Spinner， 一 旦 监控 到 EditText 的 文本 发 生变 化 ， 
就 自动 弹出 适 配 好 的 文字 下 拉 列 表 ， 选 中 具体 的 下 拉 项 向 EditText 填 入 相应 文字 。 

AutoCompleteTextView 新 增 的 几 个 属性 都 与 下 拉 列 表 有 关 ， 详 细 说 明 见 表 3-4。 











表 3-4 自动 完成 编辑 框 的 属性 和 设置 方法 说 明 




















XML 中 的 属性 AutoCompleteTextView 类 的 设置 方法 | 说 明 

completionHint setCompletionHint 设置 下 拉 列 表 底 部 的 提示 文字 

completionThreshold setThreshold 设置 至 少 输入 多 少 个 字符 才 会 显示 
提示 

dropDownHorizontalOffset | setDropDownHorizontalOffset 设置 下 拉 列 表 与 文本 框 之 间 的 水 平 
偏 移 

dropDownVerticalOffset setDropDownVerticalOffset 设置 下 拉 列 表 与 文本 框 之 间 的 垂直 
偏 移 

dropDownHeight setDropDownHeight 设置 下 拉 列 表 的 高 度 

dropDownWidth setDropDownWidth 设置 下 拉 列 表 的 宽度 

F setAdapter 设置 下 拉 列 表 的 数据 适配器 
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下 面 是 使 用 AutoCompleteTextView 的 代码 例子 : 


public class EditAutoActivity extends AppCompatActivity { 
// 定义 自动 完成 的 提示 文本 数组 
private String[] hintArray = {" 第 一 ", "第 一 次 ", "第 一 次 写 代码 ", "第 一 次 领 工资 ", "第 二 ", "第 二 个 "}; 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_edit_auto); 
// 从 布局 文件 中 获取 名 叫 ac_text 的 自动 完成 编辑 框 
AutoCompleteTextView ac_text = findViewById(R.id.ac text); 
// 声明 一 个 自动 完成 时 下 拉 展 示 的 数组 适配器 
ArrayAdapter<String> adapter = new ArrayAdapter<String>( 

this, R.layout.item_dropdown, hintArray); 

/ 设置 自动 完成 编辑 框 的 数组 适配器 
ac_text.setAdapter(adapter); 


} 
自动 完成 编辑 框 的 具体 效果 如 图 3-19 所 示 , 下 拉 列 表 的 内 容 会 自动 与 输入 文本 进行 匹配 。 





第 一 


第 一 次 
第 一 次 写 代码 
第 一 次 领 工资 





图 3-19 自动 完成 编辑 杠 的 自动 匹配 下 拉 列 表 
3.5 活动 Activity 基础 


本 节 介绍 Android 四 大 组 件 之 一 Activity 的 基本 概念 和 常见 用 法 。 首 先 说 明 Activity 的 生 
命 周期 ， 接 着 说 明 Intent 的 组 成 部 分 与 工作 原理 ， 然 后 阐述 如 何 使 用 Intent 完成 活动 页 面 之 间 
的 消息 传递 ， 包 括 如 何 传递 请 求 参数 、 如 何 返 回应 答 参 数 等 。 
3.5.1 Activity 的 生命 周期 

看 到 这 里 ， 相 信 读 者 对 Activity 已 经 不 陌生 了 。 首 先 ,一 个 Activity 代表 一 个 页 面 。 其 次 ， 
Activity 的 onCreate 方法 是 页 面 的 入 口 函数 。 更 细心 的 读者 也 许 已 经 知道 调用 startActivity 方 
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法 可 以 跳 转 到 下 一 个 页 面 。 之 所 以 到 这 时 才 介绍 Activity， 是 因为 Activity 的 逻辑 复杂 、 概 念 
繁多 ， 必 须 在 有 一 定 基 础 后 讲解 才 合 适 ， 不 然 一 开始 就 讲解 高 深 的 专业 术语 ， 读 者 恐怕 很 难 


理解 。 





首先 介绍 Activity 的 生命 周期 ， 如 同 花 开花 落 一 般 ，Activity 也 有 从 含苞 待 放 到 盛开 再 到 
凋零 的 生命 过 程 。 下 面 是 Activity 与 生命 周期 有 关 的 方法 说 明 。 


onCreate: 创建 页 面 。 把 页 面 上 的 各 个 元 素 加 载 到 内 存 中 。 
onStart: 开始 页 面 。 把 页 面 显示 在 屏幕 上 。 
onResume: 恢复 页 面 。 让 页 面 在 屏幕 上 活动 起 来 ， 例 如 开启 动画 、 开 始 任务 等 。 
onPause: 暂停 页 面 。 让 页 面 在 屏幕 上 的 动作 停 下 来 。 

onStop: 停止 页 面 。 把 页 面 从 屏幕 上 撤 下 来 。 

onDestroy: 销毁 页 面 。 把 页 面 从 内 存 中 清除 掉 。 

onRestart: 重启 页 面 。 重 新 加 载 内 存 中 的 页 面 数据 。 





下 面 针 对 几 个 常见 的 业务 场景 探究 一 下 Activity 的 生命 周期 ， 主 要 有 3 个 场景 : 页 面 之 间 
的 跳 转 、 竖 屏 与 横 屏 的 切换 、 按 HOME 键 与 返回 App。 用 于 场景 测试 的 代码 如 下 ， 主 要 在 每 
个 生命 周期 函数 中 增加 打印 屏幕 日 志和 后 台 日 志 。 


public class AcUumpActivity extends AppCompatActivity implements OnClickListener { 


private final static String TAG = "AcUumpActivity"; 
private TextView tv_life; 
private String mStr = ""; 


private void refreshLife(String desc) { // 刷新 生命 周期 的 日 志 信息 
Log.d(TAG, desc); 
mStr = String.format("%s%s %s %s\n", mStr, DateUtil.getNowTimeDetail(), TAG, desc); 
tv_life.setText(mStr); 


) 


@Override 

protected void onCreate(Bundle savedInstanceState) { / 创建 活动 页 面 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_act_jump); 
findViewByld(R.id.btn_act_next).setOnClickListener(this); 
tv_life = findViewById(R.id.tvy_life); 
refreshLife("onCreate"); 

} 


@Override 

protected void onStart0 { / 开始 活动 页 面 
refreshLife("onStart"); 
super.onStart(); 
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@Override 

protected void onStop() { // 停止 活动 页 面 
refreshLife("onStop"); 
super.onStop(); 


@Override 

protected void onResume() { / 恢复 活动 页 面 
refreshLife("onResume"); 
super.onResume(); 


@Override 

protected void onPause() { // 暂停 活动 页 面 
refreshLife("onPause"); 
super.onPause(); 


@Override 

protected void onRestart() { / 重启 活动 页 面 
refreshLife("onRestart"); 
super.onRestart(); 


@Override 

protected void onDestroy() { / 销毁 活动 页 面 
refreshLife("onDestroy"); 
super.onDestroy(); 


@Override 
public void onClick(View v) { 
if (v.getId() 一 Rid.btn_act_ next) { 
/ 准备 跳 到 下 个 活动 页 面 ActNextActivity 
Intent intent = new Intent(this, ActNextActivity.class); 
// 期 望 接收 下 个 页 面 的 返回 数据 
startActivityForResult(intent 0); 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { / 接收 返回 数据 
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} 


String nextLife = data.getStringExtra("life"); 
refreshLife("\n" + nextLife); 
refreshLife("onActivityResult"); 


super.onActivityResult(requestCode, resultCode, data); 


1. 页 面 之 间 的 跳 转 
首先 进入 测试 页 面 ActJumpActivity, 接着 从 该 


页 面 跳 转 到 


ActNextActivity ， 然 后 从 


ActNextActivity 返回 ActJumpActivity。 界面 上 的 日 
志 截 图 如 图 3-20 所 示 。 其 中 ， 区 域 1 表示 进入 页 
面 AcUumpActivity 时 的 生命 周期 过 程 ， 区 域 2 表 
示 跳 转 到 ActNextActivity 时 的 生命 周期 过 程 , 区 域 


3 表示 返 


从 日 志 截 图 可 以 看 到 ， 下 
上 一 个 页 面 的 停止 ,不 过 显示 的 日 志 信息 不 够 完 


整 。 下 面 跟踪 一 下 logcat 里 的 日 志 





跳 到 下 个 页 面 







20:30:20.916 ActJumpActivity onCreate 1 
20:30:20.916 ActJumpActivity onStart 
20:30:20.916 ActJumpActivity onResume 








回 AcUumpActivity 时 的 生命 周期 过 程 。 
-个 页 面 的 创建 伴随 


看 看 这 中 间 到 


底 发 生 了 什么 。 


11:30:18.352: D/ActJumpActivity(2315): onCreate 
11:30:18.352: D/ActJumpActivity(2315): onStart 
11:30:18.352: D/ActJumpActivity(2315): onResume 


从 ActJumpActivity 跳 转 到 ActNextActivity， 调 用 方法 的 顺序 为 : 上 一 个 页 面 onPause 一 下 
-个 页 面 onCreate 一 onStart 一 onResume 一 上 一 个 页 面 onStop。 日 志 如 下 : 


11:30:32.668: 
11:30:32.688: 
11:30:32.688: 
11:30:32.688: 
11:30:33.116: 


D/ActJumpActivity(2315): onPause 
D/ActNextActivity(2315): onCreate 
D/ActNextActivity(2315): onStart 
D/ActNextActivity(2315): onResume 
D/ActJumpActivity(2315): onStop 


20:30:22.524 ActJumpActivity onPause 

20:30:22.972 ActJumpActivity onStop 

20:30:40.657 ActJumpActivity > 
20:30:22.568 ActNextActivity onCreate 
20:30:22.568 ActNextActivity onStart 
20:30:22.568 ActNextActivity onResume 














20:30:40.661 ActJumpActivity onActivityResult 
20:30:40.661 ActJumpActivity onRestart 3 
20:30:40.661 ActJumpActivity onStart 
20:30:40.661 ActJumpActivity onResume 








图 3-20 ”活动 页 面 跳 转 时 的 界面 日 志 截 图 
首先 打开 页 面 AcUumpActivity, 调用 方法 的 顺序 为 :本 页 面 onCreate 一 onStart 一 onResume。 
日 志 如 下 : 


从 ActNextActivity 回 到 AcUumpActivity〈 按 返回 键 或 在 代码 中 调用 finish 方法 ) ， 调 用 


的 方法 顺序 为 : 下 一 个 页 面 onPause 一 上 一 个 页 面 onRestart 一 onStart 一 onResume 一 下 


onStop 一 onDestroy。 日 志 如 下 : 


11:30:40.740: 
11:30:40.752: 
11:30:40.752: 
11:30:40.752: 
11:30:41.160: 


D/ActNextActivity(2315): 
D/ActJumpActivity(2315): 
D/ActJumpActivity(2315): 
D/ActJumpActivity(2315): 
D/ActNextActivity(2315): 


onPause 
OnRestart 
onStart 
onResume 
onStop 


-个 页 面 
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11:30:41.164: D/ActNextActivity(2315): onDestroy 


至 此 ,基本 上 可 以 弄 清楚 页 面 跳 转 时 的 生命 
周期 了 7。 总体 上 是 跳 转 前 的 页 面 先 调用 onPause 。 a 
方法 ， 然 后 跳 转 后 的 页 面 依 次 调用 20:34:11.106 ActRotateActivity onCreate 
onCreate/onRestart 一 onStart 一 onResume， 最 后 跳 2 人 AR Re 
转 前 的 页 面 调用 onStop 方法 〈 若 返回 上 级 页 面 ， 
则 下 级 页 面 还 需 调 用 onDestroy 方法 ) 。 


20:36:24.558 ActRotateActivity onCreate 
20:36:24.558 ActRotateActivity onStart 


2. 坚 屏 与 横 屏 的 切换 20:36:24.558 ActRotateActivity onResume 


首先 进入 测试 页 面 ActRotateActivity， 此 时 Middle 
默认 为 竖 屏 显示 ; 接着 倒转 手机 切换 到 横 屏 ， 观 20:40:11.632 ActRotateActivity onCreate 
察 日 志 :然后 合 转 手机 切换 回 坚 屏 ， 观 察 日 志 。 。 | 各 从 耻 2 人 Roy Sn 。 
3 个 屏幕 的 显示 日 志 时 间 没 有 重复 ， 这 里 的 日 志 
截图 是 3 次 截图 拼接 而 成 的 ， 如 图 3-21 所 示 。 3-21 活动 页 面 在 横竖 屏 切 换 时 的 界面 日 志 稚 
从 日 志 截 图 可 以 看 出 ， 竖 屏 与 横 屏 似乎 在 每 次 切换 时 页 面 都 要 重新 创建 。 为 进一步 验证 
实验 结果 ， 再 一 次 查看 logcat 里 的 日 志 信息 如 下 : 


21:02:10.179 D/ActRotateActivity: onCreate 
21:02:10.179 D/ActRotateActivity: onStart 
21:02:10.179 D/ActRotateActivity: onResume 
21:02:13.227 D/ActRotateActivity: onPause 
21:02:13.227 D/ActRotateActivity: onStop 
21:02:13.227 D/ActRotateActivity: onDestroy 
21:02:13.247 D/ActRotateActivity: onCreate 
21:02:13.247 D/ActRotateActivity: onStart 
21:02:13.247 D/ActRotateActivity: onResume 
21:02:16.239 D/ActRotateActivity: onPause 
21:02:16.239 D/ActRotateActivity: onStop 
21:02:16.239 D/ActRotateActivity: onDestroy 
21:02:16.279 D/ActRotateActivity: onCreate 
21:02:16.279 D/ActRotateActivity: onStart 
21:02:16.279 D/ActRotateActivity: onResume 


分 析 日 志 的 时 间 与 内 容 ， 无 论 是 竖 屏 切 换 到 横 屏 ， 还 是 横 屏 切换 到 竖 屏 ， 都 是 原 屏幕 的 
页 面 从 onPause 到 onStop 再 到 onDestroy 一 路 销毁 ， 然 后 新 屏幕 的 页 面 从 onCreate 到 onStart 
再 到 onResume 一 路 创建 而 来 。 


3. 按 HOME 键 与 返回 App 


首先 进入 测试 页 面 ActHomeActivity; 接着 按 HOME 键 , 屏幕 回 到 桌面 ; 然后 按 任 务 键 或 
长 按 HOME 键 (不同 手 机 的 操作 不 一 样 )， 屏 幕 调 出 进程 视图 ， 最 后 点 击 测试 App， 屏 幕 返 
回 测试 页 面 。 一 路 下 来 的 屏幕 日 志 截 图 如 图 3-22 所 示 。 

















第 3 章 中 级 控件 | 83 








20:27:42.586 ActHomeActivity onCreate 
20:27:42.586 ActHomeActivity onStart 
20:27:42.586 ActHomeActivity onResume 
20:27:47.538 ActHomeActivity onPause 
20:27:47.690 ActHomeActivity onStop 
20:27:51.682 ActHomeActivity onRestart 
20:27:51.682 ActHomeActivity onStart 


20:27:51.682 ActHomeActivity onResume 





图 3-22 按 HOME 键 的 界面 日 志 截 图 


从 日 志 截 图 可 以 看 到 ， 此 时 测试 页 面 的 生命 周期 是 典型 的 从 活动 状态 变 为 暂停 状态 〈 回 
到 桌面 时 ) 再 到 活动 状态 〈 返 回 App 页 面 时 ) 。 观 察 logcat 的 后 台 日 志 ， 发 现 后 台 日 志 与 屏 
幕 日 志保 持 一 致 。 


3.5.2 ”使 用 Intent 传递 消息 


Intent 的 中 文 名 是 意图 ， 意 思 是 我 想 让 你 干什么 ， 简 单 地 说 ， 就 是 传递 消息 。Intent 是 各 

个 组 件 之 间 信 息 沟通 的 桥梁 ， 既 能 在 Activity 之 间 沟 通 ， 又 能 在 Activity 与 Service 之 间 沟 通 ， 
也 能 在 Activity 与 Broadcast 之 间 沟 通 。 总 而 言 之 , Intent 用 于 处 理 Android 各 组 件 之 间 的 通信 ， 
完成 的 工作 主要 有 3 部 分 : 

(1) Intent 需 标 明 本 次 通信 请 求 从 哪里 来 、 到 哪里 去 、 要 怎么 走 。 

(2) 发 起 方 携带 本 次 通信 需要 的 数据 内 容 ， 接 收 方 对 收 到 的 Intent 数据 进行 解 包 。 

(3) 如 果 发 起 方 要 求 判断 接收 方 的 处 理 结果 ，Intent 就 要 负责 让 接收 方 传 回应 答 的 数据 
内 容 。 


为 了 做 好 以 上 工作 ， 就 要 给 Intent 配 上 必须 的 装备 ，Intent 的 组 成 部 分 见 表 3-5。 

















表 3-5 Intent 组 成 元 素 的 列表 说 明 








元 素 名 称 设置 方法 说 明 与 用 途 














Component setComponent 组 件 ， 用 于 指定 Intent 的 来 源 与 目的 
Action setAction 动作 ， 用 于 指定 Intent 的 操作 行为 
Data setData 即 Un， 用 于 指定 动作 要 操纵 的 数据 路 径 








Category addCategory 类 别 ， 用 于 指定 Intent 的 操作 类 别 
数据 类 型 ， 用 于 指定 Data 类 型 的 定义 
扩展 信息 ， 用 于 指定 装载 的 参数 信息 


标志 位 ， 用 于 指定 Intent 的 运行 模式 〈 启 动 标志 ) 







Type setType 
Extras putExtra 


















setFlags 
表达 Intent 的 来 往 路 径 有 两 种 方式 ， 一 种 是 显 式 Intent， 另 一 种 是 隐 式 Intent。 
1. 显 式 Intent， 直 接 指定 来 源 类 与 目标 类 名 ， 属 于 精确 匹配 。 


在 声明 一 个 Intent 对 象 时 ,需要 指定 两 个 参数 ,第 一 个 参数 表示 跳 转 的 来 源 页 面 ,第 二 个 
参数 表示 接 下 来 要 跳 转 到 的 页 面 类 。 具 体 的 声明 方式 有 如 下 3 种 : 
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(1) 在 构造 函数 中 指定 ， 示 例 代码 如 下 : 
Intent intent = new Intent(this, ActResponseActivity.class); “// 创建 一 个 目标 确定 的 意 
(2) 调用 setClass 方法 指定 ， 示 例 代 码 如 下 : 
Intent intent = new Intent(); / 创建 一 个 新 意 
intent.setClass(this, ActResponseActivity.class); / 设置 意图 要 跳 转 的 活动 类 
(3) 调用 setComponent 方法 指定 ， 示 例 代码 如 下 : 
Intent intent = new Intent(0); / 创建 一 个 新 意图 


ComponentName component = new ComponentName(this, ActResponseActivity.class); 
intent.setComponent(component); / 设置 意图 携带 的 组 件 信息 


2. 隐 式 Intent， 没 有 明确 指定 要 跳 转 的 类 名 ， 只 给 出 一 个 动作 让 系统 匹配 拥有 相同 字 串 
定义 的 目标 ， 属 于 模糊 匹配 。 

因为 我 们 常常 不 希望 直接 暴露 源码 的 类 名 ， 只 给 出 一 个 事先 定义 好 的 名 称 ， 这 样 大 家 约 
定 俗 成 、 按 图 索 怠 就 好 ， 所 以 隐 式 Intent 起 到 了 过 滤 作 用 。 这 个 定义 好 的 动作 名 称 是 一 个 字符 
串 ， 可 以 是 自己 定义 的 动作 ， 也 可 以 是 已 有 的 系统 动作 。 系 统 动作 的 取 值 说 明 见 表 3-6。 


表 3-6 系统 动作 的 取 值 说 明 














Intent 类 的 系统 动作 常量 名 ”| 系统 动作 的 常量 值 说 明 

ACTION_MAIN android.intent.action.MAIN App 启动 时 的 入 口 
ACTION_VIEW android.intent.action.VIEW 显示 数据 给 用 户 

ACTION_EDIT android.intent.action.EDIT 显示 可 编辑 的 数据 
ACTION_SEND android.intent.action.SEND 分 享 内 容 

ACTION_CALL android.intent.action.CALL 直接 拨号 

ACITON_DIAL android.intent.action.DIAL 准备 拨号 

ACTION_SENDTO android.intent.action.SENDTO 发 送 短信 

ACTION_ANSWER android.intent.action.ANSWER 接听 电话 

ACTION_SEARCH android.intentaction.SEARCH 导航 栏 上 SearchView 的 搜索 动作 





这 个 动作 名 称 通过 setAction 方法 指定 , 也 可 以 通过 构造 函数 Intent(String action) 直 接生 成 
Intent 对 象 。 当 然 ， 由 于 动作 是 模糊 匹配 ， 因 此 有 时 需要 更 详细 的 路 径 ， 比 如 知道 某 人 住 在 天 
通 苑 小 区 ， 并 不 能 直接 找到 他 家 ， 还 得 说 明 他 住 在 天 通 苑 的 哪 一 期 、 哪 号 楼 、 哪 一 层 、 哪 一 个 
单元 ,Uri 和 Category 便 是 这 样 的 路 径 与 门类 信息 , Uri 数据 可 通过 构造 函数 Intent(String action, 
Uri uri) 在 生成 对 象 时 一 起 指定 ， 也 可 通过 setData 方法 指定 (setData 这 个 名 字 有 歧义 ， 实 际 就 
是 setUri) ; Category 可 通过 addCategory 方法 指定 ， 之 所 以 用 add 而 不 用 set 方法 ， 是 因为 一 
个 Intent 可 同时 设置 多 个 Category， 一 起 进行 过 滤 。 

下 面 是 一 个 调用 系统 拨号 程序 的 例子 ， 其 中 就 用 到 了 Uri: 

Intent intent = new Intent0); / 创建 一 个 新 意 
intent setAction(IntentACTION_CALL); / 设置 意图 动作 为 直接 拨号 
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Uri uri = Uriparse("tel:" + phone); / 声明 一 个 拨号 的 Uri 

intent.setData(uri); / 设置 意图 前 往 的 路 径 

startActivity(intent); / 启动 意图 通 往 的 活动 页 面 

隐 式 Intent 还 用 到 了 过 滤器 的 概念 , 即 把 不 符合 匹配 条 件 的 过 滤 掉 ， 剩 下 符合 条 件 的 按照 

优先 顺序 调用 。 创 建 一 个 Android 工程 ，AndroidManifest.xml 里 的 intent-filter 就 是 XML 中 的 
过 滤器 。 比 如 下 面 这 个 最 常见 的 主页 面 MainAcitivity，activity 节点 下 面 便 设置 了 action 和 
category 的 过 滤 条 件 。 其 中 ，android.intent.action.MAIN 表示 App 的 入 口 动作 ， 
android.intent.category.LAUNCHER 表示 在 App 启动 时 调用 。 





<activity 
android:name=".MainActivity" 
android:label="(@string/app_name" > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


3.5.3 ”向 下 一 个 Activity 传递 参数 


前 面 讲 过 ，Intent 的 setData 方法 只 指定 到 达 目 标的 路 径 ， 并 非 本 次 通信 所 携带 的 参数 信 
息 , 真正 的 参数 信息 存放 在 Extras 中 。 Intent 重 载 了 很 多 种 putExtra 方法 传递 各 种 类 型 的 参数 ， 
包括 String、int、double 等 基本 数据 类 型 ， 甚 至 Parcelable、Serializable 等 序列 化 结构 。 不 过 
只 是 调用 putExtra 方法 显然 不 好 管理 , 像 送 快 递 一 样 大 小 包 吾 随便 扔 ,不 但 找 起 来 不 方便 ， 丢 
了 也 难以 知道 。 所 以 Android 引入 了 Bundle 概念 ， 可 以 把 Bundle 理解 为 超市 的 寄 包 柜 或 快递 
收 件 柜 ， 大 小 包 库 由 Bundle 统一 存 取 ， 方 便 又 安全 。 
Bundle 内 部 用 于 存放 数据 的 实质 结构 是 Map 映射 ， 可 添加 元 素 、 删 除 元 素 ， 还 可 判断 元 
是 否 存在 。 开 发 者 把 Bundle 全 部 打包 好 只 需 调用 一 次 putExtras 方法 ， 把 Bundle 全 部 取出 
来 也 只 需 调 用 一 次 getExtras 方法 。 
下 面 是 前 一 个 页 面向 后 一 个 页 面 发 送 请 求 数据 的 代码 : 
Intent intent = new Intent(MainActivity.this, FirstActivity.class); // 创建 一 个 目标 确定 的 意图 
Bundle bundle = new Bundle0; / 创建 一 个 新 包 于 
bundle.putString("name", " 张 三 "); / 往 包 于 存 入 一 个 字符 串 
bundle.putInt("age", 30); / 往 包 衷 存 入 一 个 整 型 数 
bundle.putDouble("height", 170.0D; / 往 包 庄 存 入 一 个 双 精 度数 
intentputExtras(bundle); / 把 快递 包 庄 塞 给 意图 
startActivity(intent); / 启动 意图 所 向 往 的 活动 页 面 


下 面 是 后 一 个 页 面 接收 前 一 个 页 面 请 求 数 据 的 代码 : 


Intent intent = getIntent(); // 获取 前 一 个 页 面 传 来 的 意图 
Bundle bundle = intent.getExtras(); / 抒 下 意图 里 的 快递 包 庄 
String name = bundle.getString("name", "); / 从 包 庄 中 取出 字符 趾 
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int age = bundle.getInt("age", 0); / 从 包 奢 中 取出 整 型 数 
double height = bundle.getDouble("height", 0.0D; / 从 包 庄 中 取出 双 精 度数 


3.5.4 向 上 一 个 Activity 返回 参数 


如 同一 般 的 通信 一 样 ，Intent 有 时 只 把 请 求 数据 发 送 到 下 一 个 页 面 就 行 ， 有 时 还 要 处 理 下 

-个 页 面 的 应 答 数据 (通常 发 生 在 下 一 个 页 面 返回 到 上 一 个 页 面 时 ) 。 如 果 只 把 请 求 数据 发 送 

到 下 一 个 页 面 ， 前 一 个 页 面 调用 startActivity 方法 就 可 以 ; 如 果 还 要 处 理 一 下 个 页 面 的 应 答 数 
据 ， 此 时 就 得 分 多 步 处 理 ， 详 细 步 骤 如 下 : 


EXi 前 一 个 页 面 打包 好 请 求 数据 ， 调 用 方法 startActivityForResult(Intent intent，int 
requestCode)， 表 示 需 要 处 理 结 果 数 据 ， 第 二 个 参数 表示 请 求 编号 ， 用 于 标识 每 次 请 求 的 唯一 性 。 

CELT02 后 一 个 页 面 接收 请 求 数据 ， 进 行 相应 处 理 。 

CT03 后 一 个 页 面 在 返回 前 一 个 页 面 时 ， 打 包 应 答 数 据 并 调用 setResult 方法 返回 信息 。 
setResult 的 第 一 个 参数 表示 应 答 代码 (成 功 还 是 失败 )， 代 码 示例 如 下 : 


Intent intent = new Intent(0); / 创建 一 个 新 意图 

Bundle bundle = new Bundle0; / 创建 一 个 新 包 衷 
bundle.putString("job", " 码 农 ); / 往 包 衷 存 入 一 个 字符 串 
intentputExtras(bundle); / 把 快递 包 囊 塞 给 意图 
setResult(Activity.RESULT_OK, intent); // 携带 意图 返回 前 一 个 页 面 
finish();，// 关闭 当前 页 面 


C04 前 一 个 页 面 重 写 方 法 onActivityResult， 该 方法 的 输入 参数 包含 请 求 编号 和 应 答 代码 ， 
请 求 编号 用 于 判断 对 应 哪 次 请 求 ,应 答 代 码 用 于 判断 后 一 个 页 面 是否 处 理 成 功 。 然后 对 应 答 数据 进 
行 解 包 处 理 ， 代 码 示例 如 下 : 


// 接收 后 一 个 页 面 的 返回 数据 。 其 中 requestCode 为 请 求 代码 ， 

// resultCode 为 结果 代码 ，intent 为 后 一 个 页 面 返回 的 意图 

public void onActivityResult(int requestCode, int resultCode, Intent intent) { 
Bundle resp = intent.getExtras(); / 外 下 意图 里 的 快递 包 囊 
String job = resp.getString("job"); / 从 包 衷 中 取出 字符 串 
Toast.makeText(this, "您 目前 的 职业 是 "+job, Toast.LENGTH_LONG).show(); 















































上 


下 面 是 完整 的 请 求 页 面 代码 与 应 答 页 面 代 码 , 结合 效果 界面 加 深 对 Activity 处 理 参数 传递 
的 理解 。 请 求 页 面 的 代码 示例 如 下 : 


public class ActRequestActivity extends AppCompatActivity implements OnClickListener { 
private EditText et_request; / 声明 一 个 编辑 框 对 象 
private TextView tv_request; // 声明 一 个 文本 视图 对 象 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_act_request); 
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findViewById(R.id.btn_act request).setOnClickListener(this); 
/ 从 布局 文件 中 获取 名 叫 et_request 的 编辑 框 

et _ request = findViewById(R.id.et_request); 

/ 从 布局 文件 中 获取 名 叫 tv_request 的 文本 视图 
tv_request = findViewById(R.id.tv_request); 


@Override 
public void onClick(View v) { 
if (v.getld() 一 R.id.btn act request) { 

// 创建 一 个 新 意图 
Intent intent = new Intent(); 
// 设置 意图 要 跳 转 的 活动 类 
intent.setClass(this, ActResponseActivity.class); 
// 往 意图 存 入 名 叫 request_time 的 字符 串 
intent.putExtra("request_time", DateUtil.getNow Time()); 
// 往 意 图 存 入 名 岂 request_content 的 字符 串 
intent.putExtra("request_content", et_request.getText().toString()); 
// 期 望 接收 下 个 页 面 的 返回 数据 
startActivityForResult(intent, 0); 


} 


// 从 后 一 个 页 面 携带 参数 返回 当前 页 面 时 触发 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { V// 接收 返回 数据 
if (data != nulD { 
/1/ 从 意图 中 取出 名 叫 response_time 的 字符 串 
String response_time = data.getStringExtra("response_time"); 
/ 从 意图 中 取出 名 叫 response_content 的 字符 串 
String response_content = data.getStringExtra("response_content"); 
String desc = String.format(" 收 到 返回 消息 : \n 应 答 时 间 为 %s\n 应 答 内 容 为 %s"， 
Tesponse_time, response_content); 
/ 把 返回 消息 的 详情 显示 在 文本 视图 上 
ty_request.setText(desc); 


} 
应 答 页 面 的 代码 示例 如 下 : 


public class ActResponseActivity extends AppCompatActivity implements OnClickListener { 
private EditText et_response; / 声明 一 个 编辑 框 对 象 
private TextView tv_response; / 声明 一 个 文本 视图 对 象 
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@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_act_response); 
findViewById(R.id.btn act response).setOnClickListener(this); 
// 从 布局 文件 中 获取 名 叫 et_response 的 编辑 框 
et_ response = findViewById(R.id.et_ response); 
/ 从 布局 文件 中 获取 名 叫 tv_response 的 文本 视图 
tv_response= findViewById(R.id.tv_response); 
/ 从 前 一 个 页 面 传 来 的 意图 中 获取 快递 包 衷 
Bundle bundle = getIntent().getExtras(); 
/ 从 包 于 中 取出 名 叫 request_time 的 字符 串 
String request_time = bundle.getString("request_time"); 
// 从 包 庄 中 取出 名 叫 request_content 的 字符 串 
String request_content = bundle.getString("request_content"); 
String desc = String.format(" 收 到 请 求 消息 : \n 请 求 时 间 为 %s\n 请 求 内 容 为 %s"， 

request_time, request_content); 

/ 把 请 求 消息 的 详情 显示 在 文本 视图 上 
tv_response.setText(desc); 


} 


@Override 
public void onClick(View v) { 
if (v.getId() 一 R.id.btn_act_response) { 

Intent intent = new Intent(); / 创建 一 个 新 意图 
Bundle bundle = new Bundle0; / 创建 一 个 新 包 裴 
// 往 包 里 存 入 名 叫 response_time 的 字符 串 
bundle.putString("response_time", DateUtil.getNowTime()); 
// 往 包 庄 存 入 名 叫 response_content 的 字符 串 
bundle.putString("response_content", et_response.getText().toString()); 
intent.putExtras(bundle);， // 把 快递 包 右 塞 给 意图 
setResult(Activity.RESULT_OK, intenb; // 携带 意图 返回 前 一 个 页 面 
finish(); / 关闭 当前 页 面 


} 
具体 的 效果 图 分 别 如 图 3-23、 图 3-24、 图 3-25 所 示 。 其 中 ,图 3-23 是 当前 页 面 要 向 下 一 
个 页 面 发 送 请 求 时 的 界面 ,图 3-24 是 下 一 个 页 面 准备 返回 上 一 个 页 面 时 的 界面 ， 图 3-25 是 上 
-个 页 面 收 到 下 一 个 页 面 应 答 时 的 界面 。 
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你 吃 了 没 ? 去 我 家 吃饭 ， 走 走 





传送 请 求 参数 





图 3-23 准备 向 下 一 个 页 面 发 送 请 求 


Middle Middle 


收 到 请 求 消息 : 你 吃 了 没 ? 去 我 家 吃饭 ， 走 走 





请 求 时 间 为 20:25:55 
请 求 内 容 为 你 吃 了 没 ? 去 我 家 吃饭 ， 走 走 


我 家 饭菜 都 做 好 了 ， 还 是 你 来 我 家 吃饭 ， 来 莉 


传送 请 求 参数 
收 到 返回 消息 : 





应 答 时 间 为 20:27:10 
返回 应 答 参数 诺 务 内 容 为 我 家 锯末 才 从 好 了 ， 还 是 人 来 我 家 吃饭 ,来 








图 3-24 下 一 个 页 面 准 备 返 回 消息 图 3-25 上 一 个 页 面 收 到 返回 消息 


3.6 ”实战 项 目 : 房贷 计算 器 


如 今 楼 市 可 真是 疯狂 ， 房 价 蹦 踏 蹦 的 坐 火 箭 飞 上 天 ， 说 到 买房 ， 自 然 少不了 房贷， 根据 
不 同 的 贷款 方式 与 还 款 方式 ， 计 算出 来 的 月 供 数 额 各 不 相同 。 如 果 手 机 上 有 个 房贷 计算 器 , 那 
可 真是 帮 了 不 少 人 的 大 忙 , 它 绝 对 是 个 方便 又 实用 的 App。 那么 就 让 我 们 编写 一 个 简易 的 房贷 


计算 器 出 来 ， 耿 晤 这 货 好 不 好 使 。 
3.6.1 设计 思 


虽说 现在 才 是 第 三 章 ， 不 过 本 书 迄 今 为 止 介绍 的 App 开 
发 知识 , 足够 写 个 房贷 计算 器 App 了 , 譬如 图 3-26 所 示 的 计 
算 器 界面 ， 基 本 将 房贷 的 各 项 计算 要 素 襄 括 在 内 ， 可 谓 八 九 
不 离 十 。 

根据 图 3-26 的 计算 器 界面 ， 结 合 房贷 的 一 些 规律 常识 ， 
很 容易 找到 该 计算 器 用 到 了 本 章 的 好 几 个 控件 ， 具 体 罗列 如 
下 : 

e 文本 编辑 框 EditText: 像 购 房 总 价 、 贷 款 总 额 这 些 金 

额 数值 ， 需 要 用 户 手工 输入 。 

ee 单 选 按钮 RadioButton: 等 额 本 息 与 等 额 本 金 是 贷款 
的 两 种 还 款 方式 ， 用 户 只 能 选择 其 中 一 种 还 款 方式 。 

。 复 选 框 CheckBox: 商业 贷款 和 公积金 贷款 ， 既 可 选 
择 其 中 一 种 ， 也 可 两 者 结合 起 来 做 组 合 贷款 。 





计算 贷款 总 额 
其 中 贷款 部 分 为 : "万 
还 款 方式 ，”@ 等 额 本 息 ” 〇 等 额 本 金 
园 亲 8: 
公积金 : 


贷款 年 限 : 5 年 ~ 
基准 利率 : 2015 年 10 月 24 日 五 年 期 商 贷 … ~ 
计算 还 款 明细 


还 款 总 额 为 : ** 万 
其 中 利息 总 额 为 : *** 万 
月 供 (每 月 还 款额 为: ** 








图 3-26 房贷 计算 器 的 效果 图 
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e。 下 拉 框 Spinner: 贷款 年 限 、 基 准 利率 这 些 有 固定 的 几 个 数值 ， 用 户 需 在 下 拉 列 表 中 选择 
其 中 一 个 。 

ee 相对 布局 RelativeLayout: 位 于 同一 行 的 几 个 控件 ， 宽 度 不 国定 又 想 填 满 整 行 的 话 ， 使 用 
相对 布局 是 最 佳 选 择 。 


其 余 还 包括 上 一 章 介 绍 的 文本 视图 TextView、 按 钮 Button、 线 性 布局 LinearLayout、 滚 动 
视图 ScrollView， 几 乎 涵盖 了 这 两 章 各 小 节 的 代表 性 控件 ， 很 适合 实战 演练 。 


3.6.2 ”小 知识 : 文本 工具 TextUtils 


虽然 Java 的 String 类 型 已 经 自 带 了 很 多 字符 串 方法 ， 能 够 满足 大 多 数 场合 的 字符 串 加 工 
要 求 ， 然 而 总 有 个 别 情况 ，String 类 型 处 理 起 来 不 够 干脆 利索 。 比 如 判断 一 个 字符 串 对 象 str 
是 否 非 空 ， 按 照 传 统 的 Java 编码 ， 校 验 字符 串 非 空 的 代码 逻辑 如 下 所 示 : 

if (str!=null && strlengthOI-O) { 
/ 进入 字符 串 非 空 的 业务 逻辑 处 理 
) 

由 上 述 的 条 件 判 断 语句 可 知 ， 检 查 字 符 串 是 否 非 空 的 时 候 ，Java 首先 判断 该 串 是 否 为 空 
指针 ， 然 后 判断 该 串 的 长 度 是 否 为 0。 这 样 校 验 固然 没 错 ， 但 非 空 判断 是 很 常见 的 操作 ， 要 是 
开发 者 给 每 个 字符 串 都 写 上 两 遍 判 断 , 算 起 来 工作 量 就 不 小 了 。 因 此 Android 专门 提供 了 文本 
工具 类 TextUtils， 用 于 简化 字符 串 的 一 些 常用 操作 ， 就 刚才 的 字符 串 非 空 判断 而 言 ， 利 用 
TextUtils 则 只 需 调 用 一 个 isEmpty 方法 便 成 : 

if (!TextUtils.isEmpty(str)) { 
/ 进入 字符 串 非 空 的 业务 逻辑 处 理 


除了 isEmpty 方法 ，TextUtils 另 有 其 他 几 个 好 用 的 字符 串 方法 ， 一 并 说 明 如 下 ， 


isEmpty: 判断 字符 串 是 否 为 空 值 。 

getTrimmedLength: 获取 字符 串 去 除 头 尾 空格 之 后 的 长 度 。 
isDigitsOnly: 判断 字符 串 是 否 全 部 由 数字 组 成 。 

ellipsize: 如 果 字 符 串 超 长 ， 则 返回 按 规则 截断 并 添加 省 略 号 的 字 串 。 


以 下 代码 演示 了 如 何 正确 调用 TextUtils 的 字符 串 方法 : 


public void onClick(View v) { 

if (v.getId) 一 Ridbtn_ empty){ 
/ 判断 字符 串 是 否 为 空 值 
boolean isEmpty = TextUtils.isEmpty(et_ input.getTextO); 
String desc = String.format(" 输 入 框 的 文本 %s 空 的 ", isEmpty 2 "是 " : "不 是 "); 
tv_result.setText(desc); 

} else if (v.getId() = R.id.btn_trim length) { 
/ 获取 字符 串 去 除 头 尾 空格 之 后 的 长 度 
int length = TextUtils.getTrimmedLength(et_input.getText()); 
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String desc = String.format(" 输 入 框 的 文本 去 掉 左右 空格 后 的 长 度 是 %d", length); 
tv_result.setText(desc); 
} else if (v.getId() — R.id.btn_digit) { 
// 判断 字符 串 是 否 全 部 由 数字 组 成 
boolean isDigit = TextUtils.isDigitsOnly(et_input.getText()); 
String desc = String.format(" 输 入 框 的 文本 %s 纯 数字 ", isDigit ? "是 " : "不 是 "); 
tv_result.setText(desc); 
} else if (v.getId() 一 R.id.btn_ellipsize) { 
// 总 共 显示 十 个 字符 〈 因 为 省 略 号 占 了 一 个 ， 所 以 还 剩 九 个 可 显示 汉字 ) 
float avail = et_input.getTextSizeO0 * 10; 
// 如 果 字 符 串 超过 十 位 ， 则 返回 在 尾部 截断 并 添加 省 略 号 的 字 串 
CharSequence ellips = TextUtils.ellipsize(et_input.getText(), et_input.getPaint(), avail, 
TruncateAt.END); 
tv_result.setText(" 输 入 框 的 文本 加 省 略 号 的 样式 为 : " + ellips); 
上 
| 
接 下 来 通过 测试 页 面 观 察 这 几 个 方法 是 否 符合 预期 ，isEmpty 方法 的 运行 结果 如 图 3-27 
和 图 3-28 所 示 ， 其 中 图 3-27 为 编辑 框 没有 字符 输入 的 情况 ， 此 时 isEmpty 的 判断 是 “ 空 ”; 
图 3-28 为 编辑 框 有 输入 字符 的 情况 ， 此 时 isEmpty 的 判断 是 “ 非 空 ”。 


middle middle 








黄征 入 坟 ] 医书 使 人 进步 








文本 是 否 为 空 去 掉头 尾 空格 后 的 文本 是 否 为 空 去 掉头 尾 空格 后 的 
长 度 长 度 


是 否 由 数字 组 成 省 略 后 的 文本 是 否 由 数字 组 成 省 略 后 的 文本 
输入 框 的 文本 是 空 的 输入 框 的 文本 不 是 空 的 





3-27 编辑 框 没 输入 文本 图 3-28 编辑 框 有 输入 文本 
3.6.3 ”代码 示例 
房贷 计算 器 的 编码 过 程 分 为 三 个 步骤 : 
JI01 先 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 计算 器 页 面 的 代码 文件 取 名 


MortgageActivityjava， 布 局 文件 取 名 activity_mortgage.xml。 记 得 在 AndroidManifestxml 中 注册 该 页 面 
的 acitivity 节点 ， 注 册 代码 如 下 所 示 : 





<activity android:name=".MortgageActivity" /> 


02 在 res/layout 目录 下 创建 布局 文件 activity_mortgage.xml, 根据 页 面 效果 图 编写 计算 器 
页 面 的 布局 定义 文件 。 
在 项 目的 包 名 目录 下 创建 类 MortgageActivity, 填 入 具体 的 控件 操作 与 业务 逻辑 代码 。 


房贷 计算 器 用 到 的 所 有 控件 均 在 本 章 和 上 一 章 做 了 详细 介绍 ， 主 要 难点 反而 是 房贷 月 供 























92 | Android Studio 开发 实战 : 从 零 基础 到 App 上 线 (第 2 版 ) 


的 计算 逻辑 ， 这 部 分 的 算法 代码 参见 本 书 附带 源码 middle 模块 的 MortgageActivity.java。 下 面 
依次 过 一 下 房贷 计算 功能 的 完整 流程 。 

打开 房贷 计算 器 的 界面 ， 首 先 输入 购房 总 价 350 万 、 按 揭 比 例 70%， 点 击 “ 计 算 贷 款 总 
额 ” 按 钮 ， 则 按钮 下 方 立刻 显示 贷款 总 额 为 245 万 ， 如 图 3-29 所 示 。 


middle 


计算 贷款 总 额 
您 的 贷款 总 额 为 245.00 万 元 





3-29 计算 贷款 总 额 的 界面 


接着 勾 选 “商业 贷款 ” 复 选 框 ， 输 入 商业 贷款 的 金额 245 万 ; 点 击 贷款 年 限 的 下 拉 框 ， 
在 下 拉 列 表 中 选择 “30 年 ”, 如 图 3-30 所 示 ; 点 击 基准 利率 的 下 拉 框 , 在 下 拉 列 表 中 选择 “2015 
年 10 月 24 日 ”的 基准 利率 ， 如 图 3-31 所 示 。 


请 选择 基准 利率 


请 选择 贷款 年 限 2015 年 10 月 24 日 五 年 期 商 贫 利 
4.90% ”公积金 利 率 3.25% 

5 年 2015 年 08 月 26 日 五 年 期 商 贷 利 
5.15% ”公积金 利率 3.25% 

2015 年 06 月 28 日 五 年 期 商 贷 利 

5.40% ”公积金 利率 3.50% 

2015 年 05 月 11 日 五 年 期 商 贷 利 

5.65% ”公积金 利 率 3.75% 

2015 年 03 月 01 日 五 年 期 商 贷 利 

5.90% ”公积金 利率 4.00% 

2014 年 11 月 22 日 五 年 期 商 贷 利 

6.15% ”公积金 利率 4.25% 

2012 年 07 月 06 日 五 年 期 商 贷 利 

6.15% ”公积金 利率 4.50% 














3-30 ”选择 贷款 年 限 的 下 拉 框 图 3-31 选择 基准 利率 的 下 拉 框 


然后 点 击 “ 计 算 还 款 明细 ”按钮 ， 页 面 下 方 马 上 显示 计算 好 的 还 款 信息 如 图 3-32 所 示 ， 
其 中 利息 总 额 为 223 万 元 , 每 月 还 款 超 过 13000 元 ， 顿 时 令 人 感觉 压力 山大 。 想 起 北京 首 套房 
的 公积金 最 高 额度 为 120 万 元 ， 于 是 勾 选 “公积金 贷款 ” 复 选 框 ， 输 入 公积金 贷款 的 金额 120 
万 ， 同 时 把 商业 贷款 的 金额 改 为 125 万 。 再 次 点 击 “ 计 算 还 款 明细 ”按钮 ， 页 面 下 方 同步 显示 
最 新 的 还 款 信息 如 图 3-33 所 示 ， 此 时 利息 总 额 为 181 万 ， 每 月 还 款 不 到 12000 元 ， 果 真是 一 
目 了 然 、 方 便 快捷 。 
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middle 
购房 总 价 : 350 万 
按揭 部 分 : 70 % 
计算 贷款 总 额 
您 的 贷款 总 额 为 245.00 万 元 您 的 贷款 总 额 为 245.00 万 元 
还 款 方式 ， 图 等 额 本 息 ” 〇 等 额 本 金 还 款 方式 峡 等 额 本 息 ” 〇 等 额 本 金 
26 万 ax [到 5 
E 公积金: 120 万 
贷款 年 限 : 30 年 


基准 利率 : 2015 年 10 月 24 日 五 年 期 商 贷 … ~ 基准 利率 : 2015 年 10 月 24 日 五 年 期 商 贷 … ~ 


计算 还 款 明细 计算 还 款 明细 
和 00 万 元 您 的 贷款 总 额 为 245.00 万 元 
' 还 款 总 额 为 426.84 万 元 
其 中 利息 总 额 为 181.84 万 元 
还 款 总 时 间 为 360 月 








每 月 还 款 金 额 为 11856.56 元 


为 36| 
每 月 过 00 80 元 


图 3.32 ”只 选择 商业 贷款 时 的 计算 结果 图 3.33 同时 选择 公积金 贷款 的 计算 结果 
4 
3.7 ”实战 项 目 : 登录 App 


凡是 赚钱 的 App， 都 要 掌握 用 户 资源 ， 这 便 少 不 了 为 用 户 提供 登录 页 面 。 本 章 末尾 的 实战 
项 目 最 终 选 定 App 登录 页 面 ， 是 因为 要 复习 Activity 的 相关 概念 与 用 法 。Activity 是 Android 
中 最 常用 的 组 件 ， 后 续 章 节 全 部 都 会 用 到 ， 所 以 要 好 好 加 以 巩固 。 下 面 就 来 设计 并 实现 App 
的 登录 功能 。 


3.7.1 设计 思 


各 家 App 的 登录 页 面 大 同 小 异 ， 要 么 是 用 户 名 与 密码 组 合 登录 ， 要 么 是 手机 号 与 验证 码 
组 合 登录 ， 如 果 想 做 得 更 好 一 点 ， 就 要 提供 忘记 密码 与 记 住 密码 等 功能 。 本 章 的 App 登录 项 
目 把 这 些 功能 综合 一 下 ， 都 呈现 到 页 面 上 ， 因 为 是 练 手 ， 所 以 尽量 让 学 到 的 控件 都 派 上 用 场 。 
登录 页 面 的 设计 图 初稿 如 图 3-34 所 示 。 

读者 找 找 看 这 个 效果 图 包含 哪些 本 章 的 新 控件 ? 一 定 会 发 现 以 下 6 个 控件 。 


单 选 按 钮 RadioButton: 用 来 区 分 是 密码 登录 还 是 验证 码 登 录 。 

下 拉 框 Spinner: 用 于 区 分 用 户 类 型 是 个 人 用 户 还 是 公司 用 户 。 

编辑 框 EditText: 用 来 输入 手机 号 码 和 密码 。 

复 选 框 CheckBox: 用 于 判断 是 否 记 住 密码 。 

相对 布局 RelativeLayout: 指定 手机 号 码 的 编辑 框 放 在 手机 号 码 TextView 的 右边 。 这 
里 使 用 线性 布局 LinearLayout 也 可 以 。 

e@ 框架 布局 FrameLayout: 忘记 密码 的 按钮 与 密码 输入 框 琶 加 。 
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@ 密码 登录 C 〇 验证 码 登录 输入 新 密码 : 
我 是 : 个 人 用 户 - 确认 新 密码 : 
手机 号 码 ; 验证 码 : 获取 验证 码 
登录 密码 忘记 密码 确定 
记 住 密码 
登录 
图 3-34 登录 页 面 的 效果 图 图 3-35 ” 找 回 密码 页 面 的 效果 图 


至 此 ， 本 章 介 绍 的 新 控件 基本 都 派 上 用 场 了 。 另 外 ， 本 项 目 还 要 演示 活动 页 面 的 跳 转 功 
能 ， 点 击 “忘记 密码 ”按钮 跳 转 到 找 回 密码 页 面 ， 找 回 密码 页 面 的 效果 如 图 3-35 所 示 。 

回 密 码 的 页 面 挺 简 单 ， 主 要 问题 是 两 个 页 面 之 间 的 跳 转 有 哪些 注意 事项 ， 页 面 跳 转 肯 
定 要 传递 参数 , 一 般 唯 一 标识 的 手机 号 码 要 传 过 去 , 不 然 下 一 个 页 面 不 知道 要 为 哪个 手机 号 码 
修改 密码 ; 新 密码 也 要 传 回 去 ， 不 然 上 一 个 页 面 不 知道 密码 被 改 成 什么 了 。 

另外 ， 有 一 个 细微 的 用 户 体验 问题 : 用 户 会 去 找 回 密码 ， 肯 定 是 发 现 输入 的 密码 不 对 。 
修改 完 密 码 回 到 登录 页 面 时 , 密码 输入 框 里 还 是 原来 错误 的 密码 , 此 时 用 户 清空 错误 密码 才能 
输入 新 密码 。 我 们 的 App 想 让 用 户 觉得 好 用 ， 就 得 急用 户 之 所 急 、 想 用 户 之 所 想 ， 像 之 前 错 
误 密码 的 情况 应 当 由 App 在 返回 登录 页 面 时 自动 清空 原来 错误 的 密码 。 自 动 清空 的 操作 放 在 
onActivityResult 方法 中 处 理 是 一 个 办 法 ， 但 这 样 处 理 有 一 个 问题 ， 如 果 用 户 直 接 按 返 回 键 回 
到 登录 页 面 ，onActivityResult 方法 发 现 数据 为 空 就 不 会 处 理 。 

这 个 问题 其 实 不 难 ， 只 要 认真 看 书 ， 结合 前 面 关 于 Activity 生命 周期 的 说 明 ， 就 能 够 找到 
解决 办 法 。 重 写 onRestart 方 法 (确保 是 返回 页 面 )， 在 方法 内 部 加 上 清空 密码 框 的 处 理 即 可 。 
这 样 一 来 , 无 论 用 户 是 修改 完 密码 回 到 登录 页 ， 还 是 点 击 返 回 键 回 到 登录 页 ，App 都 会 自动 清 
空 密码 框 。 


3.7.2 ”小 知识 :提醒 对 话 框 AlertDialog 


使 用 验证 码 登录 时 ，App 要 向 用 户 手机 发 送 短信 验证 码 , 但 发 送 短信 需要 服务 器 支持 ,所 
以 这 里 暂时 使 用 随机 数 模 拟 验证 码 , 然后 以 对 话 框 的 形式 在 界面 上 提示 用 户 。 另外， 在 登录 的 
过 程 中 ，App 时 常 需要 弹 窗 提示 用 户 选 择 “ 是 ”或 “ 否 ”， 以 此 判断 下 一 步 的 处 理 逻 辑 。 在 本 
实战 项 目 开 始 之 前 ， 建 议 读者 先 演练 一 下 提醒 对 话 框 (AlertDialog) 的 用 法 。 

AlertDialog 是 Android 中 最 常用 的 对 话 框 ， 可 以 完成 常见 的 交互 操作 ， 如 提示 、 确 认 、 选 
择 等 功能 。 AlertDialog 没有 公开 的 构造 函数 , 必须 借助 AlertDialog.Builder 才能 完成 参数 设置 ， 
AlertDialog.Builder 的 常用 方法 如 下 。 

e setIcon: 设置 标题 的 图 标 。 

e@ setTitle: 设置 标题 的 文本 。 

e@ setMessage: 设置 内 容 的 文本 。 


注 
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e setPositiveButton: 设置 肯定 按钮 的 信息 ， 包 括 按钮 文本 和 点 击 监 听 器 。 
esetNegativeButton: 设置 否定 按钮 的 信息 ， 包 括 按钮 文本 和 点 击 监听 器 。 
e setNeutralButton: 设置 中 性 按钮 的 信息 ， 包 括 按钮 文本 和 点 击 监听 器 ， 该 方法 比较 少 用 。 


通过 AlertDialog.Builder 设置 完 参数 ， 还 需 调 用 create 方法 才能 生成 AlertDialog 对 象 。 最 
后 调用 AlertDialog 对 象 的 show 方法 ， 在 页 面 上 弹出 提醒 对 话 框 。 
下 面 是 个 显示 提醒 对 话 框 的 代码 例子 : 
public void onClick(View v) { 
让 (v.getId0 一 R.id.btn alert) { 
// 创建 提醒 对 话 框 的 建造 器 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
// 给 建造 器 设置 对 话 框 的 标题 文本 
builder.setTitle(" 尊 敬 的 用 户 "); 
// 给 建造 器 设置 对 话 框 的 信息 文本 
builder.setMessage(" 你 真 的 要 卸载 我 吗 ? "); 
// 给 建造 器 设置 对 话 框 的 肯定 按钮 文本 及 其 点 击 监听 器 
builder.setPositiveButton(" 残 忍 卸 载 " new DialogInterface.OnClickListenerO { 
public void onClick(DialogInterface dialog, int which) { 
tv_alert.setText(" 虽 然 依依 不 舍 ， 但 是 只 能 离开 了 "); 









上 

D); 

// 给 建造 器 设置 对 话 框 的 否定 按钮 文本 及 其 点 击 监听 器 

builder.setNegativeButton(" 我 再 想 想 ", new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int which) { 

tv_alert.setText(" 让 我 再 陪 你 三 百 六 十 五 个 日 夜 "); 

} 

D); 

/ 根据 建造 器 完成 提醒 对 话 框 对 象 的 构建 

AlertDialog alert = builder.create(); 

// 在 界面 上 显示 提醒 对 话 框 

alert.show(); 


提醒 对 话 框 的 弹 窗 效果 如 图 3-36 所 示 ， 该 对 话 框 有 标题 、 有 内 容 ， 还 有 两 个 按钮 。 


尊敬 的 用 户 
你 真 的 要 印 载 我 吗 ? 





图 3-36 AlertDialog 的 效果 图 
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用 户 点 击 不 同 的 按钮 会 触发 不 同 的 处 理 逻 辑 。 图 3-37 所 示 为 点 击 “ 我 青 想 想 ”按钮 后 的 
页 面 ， 图 3-38 所 示 为 点 击 “ 残 忍 卸 载 ” 按 钮 后 的 页 面 。 











弹出 提醒 框 弹出 提醒 框 
让 我 再 陪 你 三 百 六 十 五 个 日 夜 虽然 依依 不 舍 ， 但 是 只 能 离开 了 
图 3-37 点 击 “ 我 再 想 想 ”的 截图 图 3-38 点击 “残忍 卸载 ”的 截图 


3.7.3 ”代码 示例 


前 面 的 设计 不 但 给 出 了 两 个 页 面 的 效果 图 ， 而 且 给 出 了 业务 逻辑 的 大 概 思 路 ， 接 下 来 主 
要 是 编码 将 其 实现 。 编 码 过 程 分 为 3 个 步骤 : 

《EX6I) 先 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 登录 页 面 的 代码 文件 取 名 
LoginMainActivityjava ， 布 局 文件 取 名 activity login.xml; 找 回 密码 页 面 的 代码 文件 取 名 
LoginForgetActivityjava， 布 局 文件 取 名 activity_login_forget.xml。 记 得 在 AndroidManifest.xml 中 注 
册 两 个 页 面 的 acitivity 节点 ， 注 册 代 码 如 下 : 

<activity android:name=".LoginMainActivity" /> 
<activity android:name=".LoginForgetActivity" /> 

本 D02 在 res/layout 目录 下 创建 布局 文件 activity_login.xml 和 activity_login_forget.xml, 根据 
页 面 效 果 图 编写 两 个 页 面 的 布局 定义 文件 。 

F703 在 项 目的 包 名 目录 下 创建 类 LoginMainActivity 和 LoginForgetActivity, 填 入 具体 的 控 
件 操作 与 业务 逻辑 代码 。 

除了 登录 页 面 和 找 回 密码 页 面 ， 登 录 过 程 中 还 需要 几 个 提示 弹 窗 ， 以 便 App 与 用 户 之 间 
更 好 地 交互 。 比 如 图 3-39 为 获取 验证 码 时 候 的 弹 窗 截 图 ， 图 3-40 为 登录 成 功 之 后 的 提示 弹 窗 
截图 。 





















































请 记 住 验证 码 id 








手机 号 15960238696， 本 次 验证 码 你 的 十 机 本 而 是 19960238696; 关 


是 268767， 请 输入 验证 码 


型 是 个 人 用 户 。 恭 喜 你 通过 登录 验 
证 ， 点 击 “确定 ”按钮 返回 上 个 页 面 





好 的 





我 再 看 看 确定 返 | 














3-39 ”获取 验证 码 的 提示 对 话 框 3-40 登录 成 功 的 提示 对 话 框 


下 面 是 登录 页 面 LoginMainActivityjava 的 主要 代码 片段 ， 完 整 源码 参见 本 书 附 带 源码 
middle 模块 的 LoginMainActivityjava 和 LoginForgetActivity.java: 
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public void onClick(View v) { 
String phone = et phone.getTextO.toStringO; 
让 (v.getId0 一 R.id.btn_forget) { // 点 击 了 “忘记 密码 ”按钮 
让 (phone.length() < 11) { // 手机 号 码 不 足 11 位 
Toast.makeText(this, "请 输入 正确 的 手机 号 ", ToastLENGTH SHORT).show0; 
Tetumn; 
} 
让 (rb password.isCheckedO) { // 选择 了 密码 方式 校 验 ， 此 时 要 跳 到 找 回 密码 页 面 
Intent intent = new Intent(this, LoginForgetActivity.class); 
/ 携带 手机 号 码 跳 转 到 找 回 密码 页 面 
intent.putExtra("phone", phone); 
startActivityForResult(intent, mRequestCode); 
} else if (rb_verifycode.isChecked0) { // 选择 了 验证 码 方式 校 验 , 此 时 要 生成 六 位 验证 码 
// 生成 六 位 随机 数字 的 验证 码 
mVerifyCode = String.format("%06d", (int) (Math.random() * 1000000 % 1000000)); 
/ 弹出 提醒 对 话 框 ， 提 示 用 户 六 位 验证 码 数字 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setTitle(" 请 记 住 验证 码 "); 
builder.setMessage(" 手 机 号 "+ phone + "， 本 次 验证 码 是 "+ mVerifyCode + "， 请 输入 
验证 码 "); 
builder.setPositiveButton(" 好 的 ", null); 
AlertDialog alert = builder.create(); 
alert.show(); 
b 
} else if (v.getId() 一 R.id.btn_login) { // 点 击 了 “登录 ”按钮 
让 (phone.length()< 11) { // 手机 号 码 不 足 11 位 
Toast.makeText(this, "请 输入 正确 的 手机 号 " ToastLENGTH_ SHORT).show(0); 
return; 
} 
f(rb_password.isChecked()) { // 密码 方式 校 验 
if (!et_password.getText().toString().equals(mPassword)) { 
Toast.makeText(this, "请 输入 正确 的 密码 ", Toast.LENGTH_SHORT).show(); 
} else { / 密码 校 验 通过 
loginSuccess0); // 提示 用 户 登录 成 功 
区 
} else if (rb_verifycode.isChecked0) { / 验证 码 方式 校 验 
if (!et_password.getText().toString().equals(mVerifyCode)) { 
Toast.makeText(this, "请 输入 正确 的 验证 码 ", Toast.LENGTH_SHORT).show0; 
} else { // 验证 码 校 验 通过 
loginSuccess(); // 提示 用 户 登录 成 功 
b 
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// 从 后 一 个 页 面 携带 参数 返回 当前 页 面 时 触发 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (requestCode 一 mRequestCode && data != null) { 
// 用 户 密码 已 改 为 新 密码 ， 故 更 新 密码 变量 
mPassword = data.getStringExtra("new_password"); 


// 从 修改 密码 页 面 返回 登录 页 面 ， 要 清空 密码 的 输入 框 
protected void onRestart() { 

et_password.setText("™"); 

super.onRestart(); 
b 


// 校 验 通过 ， 登 录 成 功 
private void loginSuccess() { 
String desc = String.format(" 您 的 手机 号 码 是 %s， 类 型 是 %s。 恭 喜 你 通过 登录 验证 ， 点 击 “ 确 
定 ” 按 钮 返回 上 个 页 面 ", et_phone.getText().toString(), typeArray[mType]); 
/ 弹出 提醒 对 话 框 ， 提 示 用 户 登 录 成 功 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setTitle(" 登 录 成 功 "); 
builder.setMessage(desc); 
builder.setPositiveButton(" 确 定 返回 ", new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int which) { 
finish(); 
} 
DD); 
buildersetNegativeButton(" 我 再 看 看 ", null); 
AlertDialog alert = builder.create(); 
alert.show(); 


3.8 小 结 


本 章 主要 介绍 App 开发 的 中 级 控件 相关 知识 ， 包 括 其 他 布局 的 用 法 (相对 布局 、 框 架 布 
局 )、 特 殊 按钮 的 用 法 复 选 框 、 开 关 按 钮 、 单 选 按 钮 》、 适 配 视图 的 基本 用 法 (下 拉 框 、 数 
组 适配器 、 简 单 适配器 ) 、 编 辑 框 的 用 法 〈 文 本 编辑 框 、 自 动 完成 编辑 框 ) 、Activity 组 件 的 
基本 用 法 〈 生 命 周期 、 意 图 、 传 递 消息 ) 。 最 后 设计 了 两 个 实战 项 目 ， 一 个 是 “房贷 计算 器 ”， 
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另 一 个 是 “登录 App”。 在 “房贷 计算 器 ”的 项 目 编码 中 ， 采 用 前 面 介绍 的 部 分 布局 和 控件 ， 
并 介绍 了 文本 工具 类 的 用 法 。 在 “登录 App” 的 项 目 编码 中 , 采用 前 面 介绍 的 大 部 分 布局 和 控 
件 ， 以 及 Activity 跳 转 与 返回 时 的 消息 请 求 与 应 答 ， 初 步 在 实际 代码 中 运用 生命 周期 方法 ， 并 
介绍 了 提醒 对 话 框 的 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 掌握 以 下 3 种 开发 技能 : 

(1) 在 布局 文件 中 合理 使 用 本 章 学 到 的 布局 和 控件 。 

(2) 在 代码 中 合理 调用 本 章 学 到 的 布局 和 控件 的 相关 方法 。 

(3) 学 会 活动 组 件 Activity 的 用 法 ， 如 在 页 面 之 间 跳 转 的 消息 传递 操作 和 在 合适 的 场合 
重 写生 命 周 期 的 方法 。 


本 章 介绍 Android 五 种 主要 存储 方式 的 用 法 ， 包 括 共享 参数 SharedPreferences、 数 据 库 
SQLite、SD 卡 文件 、App 的 全 局 内 存 ， 另 外 介绍 重要 组 件 之 一 的 应 用 Application 的 基本 概念 
与 常见 用 法 ， 以 及 四 大 组 件 之 一 的 内 容 提 供 器 ContentProvider 的 基本 概念 与 常见 用 法 。 最 后 ， 
结合 本 章 所 学 的 知识 演示 实战 项 目 “ 购 物 车 ”的 设计 与 实现 。 


4.1 共享 参数 SharedPreferences 


本 节 介绍 Android 的 键 值 对 存储 方式 一 一 共享 参数 SharedPreferences 的 使 用 方法 , 包括 如 
何 保存 数据 与 读 取 数据 ， 通 过 共享 参数 结合 “登录 App” 项 目 实现 记 住 密码 功能 。 


4.1.1 共享 参数 的 基本 用 法 


SharedPreferences 是 Android 的 一 个 轻 量 级 存储 工具 ， 采 用 的 存储 结构 是 Key-Value 的 键 
值 对 方式 ， 类 似 于 Java 的 Properties 类 ， 二 者 都 是 把 Key-Value 的 键 值 对 保存 在 配置 文件 中 。 
不 同 的 是 Properties 的 文件 内 容 是 Key=Value 这 样 的 形式 ， 而 SharedPreferences 的 存储 介质 是 
符合 XML 规范 的 配置 文件 。 保 存 SharedPreferences 键 值 对 信息 的 文件 路 径 是 /data/data/ 应 用 包 
名 /shared_prefs/ 文 件 名 .xml。 下 面 是 一 个 共享 参数 的 XML 文件 示例 : 


<?xml version="1.0' encoding='utf-8' standalone='yes' ?> 
<map> 

<string name="name">Mr Lee</string> 

<int name="age" value="30" 亡 

<boolean name="married" value="true" /> 

<float name="weight" value="100.0" /> 


第 4 章 数据 存储 | 101 





</map> 
基于 XML 格式 的 特点 ，SharedPreferences 主要 适用 于 如 下 场合 : 


(1) 简单 且 孤 立 的 数据 。 若 是 复杂 且 相 互 间 有 关 的 数据 ， 则 要 保存 在 数据 库 中 。 
(2) 文本 形式 的 数据 。 若 是 二 进 制 数据 ， 则 要 保存 在 文件 中 。 
(3) 需要 持久 化 存储 的 数据 。 在 App 退出 后 再 次 启动 时 ， 之 前 保存 的 数据 仍然 有 效 。 


实际 开发 中 ， 共 享 参数 经 常 存储 的 数据 有 App 的 个 性 化 配置 信息 、 用 户 使 用 App 的 行为 
信息 、 临 时 需要 保存 的 片段 信息 等 。 

SharedPreferences 对 数据 的 存储 和 读 取 操 作 类 似 于 Map， 也 有 put 函数 用 于 存储 数据 、get 
函数 用 于 读 取 数 据 。 在 使 用 共享 参数 之 前 ， 要 先 调 用 getSharedPreferences 函数 声明 文件 名 与 
操作 模式 ， 示 例 代 码 如 下 : 

// 从 share.xml 中 获取 共享 参数 对 象 

SharedPreferences shared = getSharedPreferences("share", MODE PRIVATE); 


getSharedPreferences 方法 的 第 一 个 参数 是 文件 名 ， 上 面 的 share 表示 当前 使 用 的 共享 参数 
文件 名 是 share.xml; 第 二 个 参数 是 操作 模式 ， 一 般 都 填 MODE PRIVATE， 表 示 私 有 模式 。 

共享 参数 存储 数据 要 借助 于 Editor 类 ， 示 例 代码 如 下 : 

SharedPreferences.Editor editor = shared.edit(); / 获得 编辑 器 的 对 象 

editor.putString("name", "Mr Lee"); / 添加 一 个 名 叫 name 的 字符 串 参 数 

editor.putInt("age", 30); / 添加 一 个 名 叫 age 的 整 型 参数 

editorputBoolean("married", true); / 添加 一 个 名 叫 married 的 布尔 型 参数 

editor.putFloat("weight", 100D; // 添加 一 个 名 叫 weight 的 浮 点 数 参 数 

editorcommit0); / 提交 编辑 器 中 的 修改 

共享 参数 读 取 数 据 相 对 简单 ， 直 接 使 用 对 象 即 可 完成 数据 读 取 方 法 的 调用 ,注意 get 方法 
的 第 二 个 参数 表示 默认 值 ， 示 例 代 码 如 下 : 

String name = shared.getString("name", "); / 从 共享 参数 中 获得 名 叫 name 的 字符 串 

int age = shared.getInt("age", 0); /人 从 共享 参数 中 获得 名 叫 age 的 整 型 数 

boolean married = shared.getBoolean("married", false); // 从 共享 参数 中 获得 名 叫 married 的 布尔 数 

float weight = shared.getFloat("weight", 0); 人/ 从 共享 参数 中 获得 名 叫 weight 的 浮 点 数 


下 面 通过 页 面 录 入 信息 演示 SharedPreferences 的 存 取 过 程 ， 如 图 4-1 所 示 。 在 页 面 上 利用 
EditText 录入 用 户 注册 信息 ， 并 保存 到 共享 参数 文件 中 。 在 另 一 个 页 面 ，App 从 共享 参数 文件 
中 读 取 用 户 注 册 信息 ， 并 将 注册 信息 依次 显示 在 页 面 中 ， 如 图 4-2 所 示 。 
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Storage storage 
共享 参数 中 保存 的 信息 如 下 : 

姓名 : Jack married 的 取 值 为 true 

PP 生生 175 
leight! p 

和 60 name 的 取 值 为 Jack 
count 的 取 值 为 3 

身高 : 175 first 的 取 值 为 false 
ne 的 和 2018 -05_23 
update_time 的 为 -05-; 

4 1 

婚 否 : 已 婚 ~ 

保存 到 共享 参数 
图 4-1 写 入 共享 参数 图 4-2 ”从 共享 参数 读 取 


4.1.2 ”实现 记 住 密码 功能 
上 一 章 的 实战 项 目 “ 登 录 App” 页 面 下 方 有 一 个 “ 记 住 密码 ” 复 选 框 ， 当 时 只 是 为 了 演示 
控件 的 运用 ， 并 未 真正 记 住 密码 。 因 为 用 户 退出 后 重新 进入 登录 页 面 , App 没有 回忆 起 上 次 用 
户 的 登录 密码 。 现 在 利用 共享 参数 对 该 项 目 进行 改造 ， 使 之 实现 记 住 密码 的 功能 。 
改造 的 内 容 主要 有 3 处 : 

















(1) 声明 一 个 SharedPreferences 对 象 ， 并 在 onCreate 函数 中 调用 getSharedPreferences 方 


法 对 该 对 象 进行 初始 化 操作 。 


(2) 登录 成 功 时 ， 如 果 用 户 勾 选 了 “ 记 住 密码 ”， 就 使 用 共享 参数 保存 手机 号 码 与 密码 。 


也 就 是 在 loginSuccess 函数 中 增加 如 下 代码 : 


// 如 果 勾 选 了 “ 记 住 密码 ”， 则 把 手机 号 码 和 密码 都 保存 到 共享 参数 中 
if(bRemember) { 


} 


SharedPreferences.Editor editor = mShared.edit(); / 获得 编辑 器 的 对 象 
editorputString("phone" et_phone.getText().toString()); / 添加 名 叫 phone 的 手机 号 码 
editor.putString("password", et_password.getText(.toString0); / 添加 名 叫 password 的 密码 
editorcommit0; / 提交 编辑 器 中 的 修改 


(3) 在 打开 登录 页 面 时 ，App 从 共享 参数 中 读 取 手机 号 码 与 密码 ， 并 展示 在 界面 上 。 也 


就 是 在 onCreate 函数 中 增加 如 下 代码 : 


/ 从 share.xml 中 获取 共享 参数 对 象 

mShared = getSharedPreferences("share_ login" MODE PRIVATE); 

/ 获取 共享 参数 中 保存 的 手机 号 码 

String phone = mShared.getString("phone", ""); 

// 获取 共享 参数 中 保存 的 密码 

String password = mShared.getString("password", ""); 
et_phone.setText(phone); / 给 手机 号 码 编辑 框 填写 上 次 保存 的 手机 号 
et password.setText(password); / 给 密码 编辑 框 填 写 上 次 保存 的 密码 
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修改 完毕 后 ， 如 果 不 出 意料 ， 只 要 用 户 上 次 登录 成 功 时 勾 选 “ 记 住 密码 ”， 下 次 进入 登 
录 页 面 时 App 就 会 自动 填写 上 次 登录 的 手机 号 码 与 密码 。 具 体 的 效果 如 图 4-3 和 图 4-4 所 示 。 
其 中 ， 图 4-3 所 示 为 用 户 首次 登录 成 功 ， 此 时 多 和 选 了 “ 记 住 密码 ”; 图 4-4 所 示 为 用 户 再 次 进 
入 登录 页 面 ， 因 为 上 次 登录 成 功 时 已 经 记 住 密码 ， 所 以 这 次 页 面 会 自动 展示 保存 的 登录 信息 。 
Storage Storage 
〇 验证 码 登录 〇 验证 码 登录 
我 是 : 个 人 用 户 外 我 是 : 个 人 用 户 


手机 号 码 : 15960238696 手机 号 码 ; 15960238696 


记 住 密码 





图 4-3 将 登录 信息 保存 到 共享 参数 图 4-4 从 共享 参数 读 取 登录 信息 
4.2 ”数据库 SQLite 


本 节 介绍 Android 的 数据 库存 储 方式 一 一 SQLite 的 使 用 方法 ， 包 括 如 何 建 表 和 删 表 、 变 
更 表 结构 以 及 对 表 数 据 进行 增加 、 删除 、 修改 、 查询 等 操作 , 然后 通过 SQLite 结合 “登录 App” 
项 目 改进 记 住 密码 功能 。 


4.2.1 SQLite 的 基本 用 法 


SQLite 是 一 个 小 巧 的 嵌入 式 数 据 库 ， 使 用 方便 、 开 发 简单 ， 手 机 上 最 早 由 iOS 运用 ， 后 
来 Android 也 采用 了 SQLite。SQLite 的 多 数 SQL 语法 与 Oracle 一 样 , 下 面 只 列 出 不 同 的 地 方 : 


(1) 建 表 时 为 避免 重复 操作 ， 应 加 上 IF NOT EXISTS 关键 词 ， 例 如 CREATE TABLE IF 
NOT EXISTS table_name。 

(2) 删 表 时 为 避免 重复 操作 ， 应 加 上 IF EXISTS 关键 词 ， 例 如 DROP TABLE IF EXISTS 
table_name。 

(3) 添加 新 列 时 使 用 ALTER TABLE table name ADD COLUMN ...， 注 意 比 Oracle 多 了 

-个 COLUMN 关键 字 。 

(4) 在 SQLite 中 ， ALTER 语句 每 次 只 能 添加 一 列 ， 如果 要 添加 多 列 , 就 只 能 分 多 次 添加 。 

(5) SQLite 支持 整 型 INTEGER、 字 符 串 VARCHAR、 浮 点 数 FLOAT, 但 不 支持 布尔 类 型 。 
布尔 类 型 数 要 使 用 整 型 保存 ， 如 果 直 接 保存 布尔 数据 ， 在 入 库 时 SQLite 就 会 自动 将 其 转 为 0 
或 1，0 表示 false，1 表示 true。 

(6) SQLite 建 表 时 需要 一 个 唯一 标识 字段 ， 字 段 名 为 id。 每 建 一 张 新 表 都 要 例行公事 加 
上 该 字段 定义 , 具体 属性 定义 为 id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL。 
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(7) 条 件 语 句 等 号 后 面 的 字符 串 值 要 用 单 引 号 括 起 来 ， 如 果 没 用 使 用 单 引 号 括 起 来 ， 在 
运行 时 就 会 报错 。 


SQLiteDatabase 是 SQLite 的 数据 库 管理 类 ， 开 发 者 可 以 在 活动 页 面 代 码 或 任何 能 取 到 
Context 的 地 方 获取 数据 库 实例 ， 参 考 代码 如 下 : 

// 创建 名 岂 test.db 的 数据 库 。 数 据 库 如 果 不 存在 就 创建 它 ， 如 果 存 在 就 打开 它 

SQLiteDatabase db = openOrCreateDatabase(getFilesDir() + "/test.db", Context. MODE_PRIVATE, nulD); 


// 删除 名 叫 test.db 数据 库 
// deleteDatabase(getFilesDir() + "/test.db"); 


SQLiteDatabase 提供 了 若干 操作 数据 表 的 API， 常 用 的 方法 有 3 类 ， 列 举 如 下 : 
1. 管理 类 ， 用 于 数据 库 层面 的 操作 。 


openDatabase: 打开 指定 路 径 的 数据 库 。 
isOpen: 判断 数据 库 是 否 已 打开 。 
close: 关闭 数据 库 。 

getVersion: 获取 数据 库 的 版 本 号 。 
setVersion: 设置 数据 库 的 版 本 号 。 


2. 事务 类 ， 用 于 事务 层面 的 操作 。 


ebeginTransaction: 开始 事务 。 

e@ setTransactionSuccessful: 设置 事务 的 成 功 标志 。 

eendTransaction: 结束 事务 ,执行 本 方法 时 , 系统 会 判断 是 否 已 执行 setTransactionSuccessful， 
如 果 之 前 已 设置 就 提交 ， 如 果 没 有 设置 就 回 滚 。 


3. 数据 处 理 类 ， 用 于 数据 表层 面 的 操作 。 


execSQL: 执行 拼接 好 的 SQL 控制 语句 。 一 般 用 于 建 表 、 删 表 、 变 更 表 结构 。 
delete: 删除 符合 条 件 的 记录 。 
update: 更 新 符合 条 件 的 记录 。 
insert: 插入 一 条 记录 。 
query: 执行 查询 操作 ， 返 回 结果 集 的 游标 。 
rawQuery: 执行 拼接 好 的 SQL 查询 语句 ， 返 回 结果 集 的 游标 。 
4.2.2 ”数据 库 帮助 器 SQLiteOpenHelper 
SQLiteDatabase 存在 局 限 性 ， 例 如 必须 小 心 、 不 能 重复 地 打开 数据 库 ， 处 理 数据 库 的 升级 
很 不 方便 。Android 提供 了 一 个 辅助 工具 一 一 SQLiteOpenHelper,， 用 于 指导 开发 者 进行 SQLite 
的 合理 使 用 。 
SQLiteOpenHelper 的 具体 使 用 步骤 如 下 : 


本 Jo1 新 建 一 个 继承 自 SQLiteOpenHelper 的 数据 库 操 作 类 , 提示 重 写 onCreate 和 onUpgrade 
两 个 方法 。 其 中 ，onCreate 方法 只 在 第 一 次 打开 数据 库 时 执行 ， 在 此 可 进行 表 结构 创建 的 操作 ; 
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onUpgrade 方法 在 数据 库 版 本 升 高 时 执行 ， 因 此 可 以 在 onUpgrade 函数 内 部 根据 新 旧版 本 号 进行 表 
结构 变更 处 理 。 


E02 封装 保证 数据 


连接 。 














库 安全 的 必要 方法 ,包括 获取 单 例 对 象 . 打开 数据 库 连接 . 关闭 数据 库 


@ 获取 单 例 对 象 : 确保 App 运行 时 数据 库 只 被 打开 一 次 ， 避 免 重复 打 开 引 起 错误 。 
@ 打开 数据 库 连 接 : SQLite 有 锁 机 制 ， 即 读 锁 和 写 锁 的 处 理 ; 故而 数据 库 连 接 也 分 两 种 ， 读 
连接 可 调用 SQLiteOpenHelper 的 getReadableDatabase 方法 获得 ， 写 连接 可 调用 


getWritableDatabase 获得 。 


关闭 数据 库 连接 : 数据 库 操作 完毕 后 ， 应 当 调 用 SQLiteDatabase 对 象 的 close 方法 关闭 连 


接 。 


C03 提供 对 表 记 录 进 行 增加 .删除 .修改 .查询 的 操作 方法 。 


可 被 SQLite 直接 使 用 的 数据 结构 是 ContentValues 类 ， 类 似 于 映射 Map， 提 供 put 和 get 
方法 用 来 存 取 键 值 对 。 区 别 之 处 在 于 ContentValues 的 键 只 能 是 字符 串 ， 查 看 ContentValues 
的 源码 会 发 现 其 内 部 保存 键 值 对 的 数据 结构 就 是 HashMap“private HashMap<String, Object> 
mValues;”。ContentValues 主要 用 于 记录 增加 和 更 新 操作 , 即 SQLiteDatabase 的 insert 和 update 


方法 。 


对 于 查询 操作 来 说 ， 使 用 的 是 另 一 个 游标 类 Cursor。 调 用 SQLiteDatabase 的 query 和 
rawQuery 方法 时 ， 返 回 的 都 是 Cursor 对 象 ， 因 此 获取 查询 结果 要 根据 游标 的 指示 一 条 一 条 遍 
历 结果 集合 。Cursor 的 常用 方法 可 分 为 3 类， 说 明 如 下 : 


Cn 


. 游标 控制 类 方法 ， 用 于 指定 游标 的 状态 。 


close: 关闭 游标 。 

isClosed: 判断 游标 是 否 关闭 。 
isFirst: 判断 游标 是 否 在 开头 。 
isLast: 判断 游标 是 否 在 末尾 。 


. 游标 移动 类 方法 ， 把 游标 移动 到 指定 位 置 。 


moveToFirst: 移动 游标 到 开头 。 

moveToLast: 移动 游标 到 末尾 。 

moveToNext: 移动 游标 到 下 一 条 记录 。 
moveToPrevious: 移动 游标 到 上 一 条 记录 。 
move: 往 后 移动 游标 若干 条 记录 。 
moveToPosition: 移动 游标 到 指定 位 置 的 记录 。 


. 获取 记录 类 方法 ， 可 获取 记录 的 数量 、 类 型 以 及 取 值 。 


getCount: 获取 结果 记录 的 数量 。 
getmt: 获取 指定 字段 的 整 型 值 。 


egetFloat: 获取 指定 字段 的 浮 点 数值 。 
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e getString: 获取 指定 字段 的 字符 串 值 。 
egetType: 获取 指定 字段 的 字段 类 型 。 
鉴于 数据 库 操 作 的 特殊 性 ， 不 方便 单独 演示 某 个 功能 ， 接 下 来 从 创建 数据 库 开 始 介绍 ， 
完整 演示 一 下 数据 库 的 读 写 操作 。 如 图 4-5 和 图 4-6 所 示 ， 在 页 面 上 分 别 录入 两 个 用 户 的 注册 
信息 并 保存 到 SQLite。 从 SQLite 读 取 用 户 注册 信息 并 展示 在 页 面 上 ， 如 图 4-7 所 示 。 





Storage Storage 





保存 到 数据 库 





图 4-5 第 一 条 注册 信息 保存 到 数据 库 图 4-6 第 二 条 注册 信息 保存 到 数据 库 
storage 


删除 所 有 记录 
FP 详情 如 下 : 


身高 为 175 

体重 为 70.000000 

婚 否 为 true 

更 新 时 间 为 2018-05-23 16:34:01 





图 4-7 从 SQLite 中 读 取 两 条 注册 记录 
下 面 是 用 户 注册 信息 数据 库 的 SQLiteOpenHelper 操作 类 的 完整 代码 : 


public class UserDBHelper extends SQLiteOpenHelper { 
private static final String DB_NAME = "user.db"; // 数据 库 的 名 称 
private static final int DB_VERSION = 1; / 数据 库 的 版 本 号 
private static UserDBHelper mHelper = null; / 数据 库 帮助 器 的 实例 
private SQLiteDatabase mDB = null; / 数据 库 的 实例 
public static final String TABLE NAME = "user_info"; // 表 的 名 称 


private UserDBHelper(Context context) { 
super(context, DB NAME, null, DB VERSION); 
上 
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private UserDBHelper(Context context, int version) { 
super(context, DB NAME, null, version); 


// 利用 单 例 模式 获取 数据 库 帮 助 器 的 唯一 实例 
public static UserDBHelper getInstance(Context context, int Version) { 
if (version > 0 && mHelper 一 nulD) { 
mHelper = new UserDBHelper(context, version); 
} else if (mHelper — null) { 
mHelper = new UserDBHelper(context); 
上 
return mHelper; 


/ 打开 数据 库 的 读 连 接 
public SQLiteDatabase openReadLinkO { 
if (mDB =— null || ImDB.isOpen()) { 
mDB = mHelper.getReadableDatabase(); 
} 


return mDB; 


/ 打开 数据 库 的 写 连接 
public SQLiteDatabase open WriteLink() { 
if (mDB 一 null || ImDB.isOpen()) { 
mDB = mHelper.getWritableDatabase(); 
} 


return mDB; 


/ 关闭 数据 库 连接 
public void closeLink() { 
if (mDB !=null && mDB.isOpen0O) { 
mDB.close(); 
mDB = nmull; 


// 创建 数据 库 ， 执 行 建 表 语句 

public void onCreate(SQLiteDatabase db) { 
String drop sql= "DROP TABLE IF EXISTS " + TABLE NAME+";"; 
db.execSQL(drop_sql); 
String create_sql ="CREATE TABLE IF NOT EXISTS "+ TABLE NAME+"(" 
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+" id INTEGER PRIMARY KEY AUTOINCREMENTNOT NULL," 

+ "name VARCHAR NOT NULL," + "age INTEGER NOT NULL," 

+ "height LONG NOT NULL," + "weight FLOAT NOT NULL," 

+ "married INTEGER NOT NULL.," + "update time VARCHAR NOT NULL" 

+",phone VARCHAR" +",password VARCHAR" + ");"; 
db.execSQL(create_sql); 


// 修改 数据 库 ， 执 行 表 结构 变更 语句 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {} 


/ 根据 指定 条 件 删除 表 记 录 

public int delete(String condition) { 
/ 执行 删除 记录 动作 ， 该 语句 返回 删除 记录 的 数目 
return mDB.delete(TABLE_ NAME, condition, null); 


// 往 该 表 添加 多 条 记录 
public long insert(ArrayList<UserInfo> infoArray) { 
long result = -1; 
for (inti= 0; i< infoArray.size(); i++) { 
UserInfo info = infoArray.get(i); 
ArrayList<UserInfo> tempArray = new ArrayList<UserInfo>(); 
// 如 果 存 在 同样 的 手机 号 码 ， 则 更 新 记录 
/ 注意 条 件 语句 的 等 号 后 面 要 用 单 引 号 括 起 来 
让 (info.phone != null && info.phone.lengthO > 0) { 
String condition = String.format("phone=%s", info.phone); 
tempArray = query(condition); 
if (tempArray.size() > 0) { 
update(info, condition); 
result = tempArray.get(0).rowid; 


continue; 


} 

// 不 存在 唯一 性 重复 的 记录 ， 则 插入 新 记录 
ContentValues cv = new ContentValues(); 
cv.put("name", info.name); 

cv.put("age", info.age); 

cv.put("height", info.height); 

cv.put("weight", info.weight); 
cv.put("married", info.married); 
cv.put("update_time", info.update_time); 
cv.put("phone", info.phone); 





} 


cv.put("password", info.password); 
/ 执行 插入 记录 动作 ， 该 语句 返回 插入 记录 的 行 号 
result = mDB.insert(TABLE NAME, "", cv); 
// 添加 成 功 后 返回 行 号 ， 失 败 后 返回 -1 
if (result 一 -1) { 
return result; 


} 
Teturn result; 


/ 根据 条 件 更 新 指定 的 表 记 录 
public int update(UserInfo info, String condition) { 


) 


ContentValues cv = new ContentValues(); 
cv.put("name", info.name); 

cv.put("age", info.age); 

cv.put("height", info.height); 

cv.put("weight", info.weight); 

cv.put("married", info.married); 

cv.put("update_time", info.update_time); 
cv.put("phone", info.phone); 

cv.put("password", info.password); 

/ 执行 更 新 记录 动作 ， 该 语句 返回 记录 更 新 的 数目 
return mDB.update(TABLE_ NAME, cv, condition, nulD; 


/ 根据 指定 条 件 查询 记录 ， 并 返回 结果 数据 队列 
public ArrayList<UserInfo> query(String condition) { 


String sql = String.format("select rowid, id,name,age,height,weight,married,update_time," + 
"phone,password from %s where %s:", TABLE_NAME, condition); 
ArrayList<UserInfo> infoArray = new ArrayList<UserInfo>(); 
// 执行 记录 查询 动作 ， 该 语句 返回 结果 集 的 游标 
Cursor cursor = mDB.rawQuery(sql, null); 
/ 循环 取出 游标 指向 的 每 条 记录 
while (cursor.moveToNext()) { 
UserInfo info = new UserInfo(); 
info.rowid = cursor.getLong(0); / 取出 长 整 型 数 
info.xuhao = cursor.getInt(1); / 取出 整 型 数 
info.name = cursor.getString(2); / 取出 字符 串 
info.age = cursor.getInt(3); 
info.height = cursor.getLong(4); 
info.weight = cursor.getFloat(5); / 取出 浮 点 数 
/SQLite 没有 布尔 型 ， 用 0 表示 false， 用 1 表示 true 
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info.married = (cursor.getInt(6) 一 0) ? false : true; 
info.update_time = cursor.getString(7); 
info.phone = cursor.getString(8); 
info.password = cursor.getString(9); 
infoArray.add(info); 

b 

cursor.close(); / 查询 完毕 ， 关 闭 游标 

return infoArray; 

} 


// 根据 手机 号 码 查 询 指定 记录 
public UserInfo queryByPhone(String phone) { 
UserInfo info = null; 
ArrayList<UserInfo> infoArray = query(String.format("phone='%s", phone)); 
if (infoArray.size() > 0) { 
info = infoArray.get(0); 
} 


return info; 


} 
4.2.3 ”优化 记 住 密码 功能 


在 “4.1.2 实现 记 住 密码 功能 ”中 ， 我 们 利用 共享 参数 实现 了 记 住 密码 的 功能 ， 不 过 这 个 
方法 有 局 限 ， 只 能 记 住 一 个 用 户 的 登录 信息 , 并且 手机 号 码 跟 密 码 不 存在 从 属 关 系 ， 如 果 换 个 
手机 号 码 登 录 , 前 一 个 用 户 的 登录 信息 就 被 覆盖 了 。 真正 意义 上 的 记 住 密码 功能 是 先 输入 手机 
号 码 , 然后 根据 手机 号 匹配 保存 的 密码 ， 一 个 密码 对 应 一 个 手机 号 码 ， 从 而 实现 具体 手机 号 码 
的 密码 记忆 功能 。 

现在 运用 SQLite 技术 分 条 存储 不 同 用 户 的 登录 信息 ， 并 提供 根据 手机 号 码 查找 登录 信息 
的 方法 ， 这 样 可 以 同时 记 住 多 个 手机 号 码 的 密码 。 具 体 的 改造 主要 有 以 下 3 点 : 

(1) 声 明 一 个 UserDBHelper 对 象 , 然后 在 活动 页 面 的 onResume 方法 中 打开 数据 库 连 接 ， 
在 onPasue 方法 中 关闭 数据 库 连 接 ， 示 例 代 码 如 下 : 

private UserDBHelper mHelper; / 声明 一 个 用 户 数据 库 帮 助 器 对 象 





@Override 

protected void onResume() { 
super.onResume(); 
/ 获得 用 户 数 据 库 帮助 器 的 一 个 实例 
mHelper = UserDBHelper.getInstance(this, 2); 
/ 恢复 页 面 ， 则 打开 数据 库 连接 
mHelper.open WriteLink(); 





@Override 
protected void onPause() { 
super.onPause(); 
/ 暂停 页 面 ， 则 关闭 数据 库 连 接 
mHelpercloseLinkO:; 
上 
(2) 登录 成 功 时 ， 如 果 用 户 色 选 了 “ 记 住 密码 ”， 就 使 用 数据 库 保存 手机 号 码 与 密码 在 
内 的 登录 信息 。 也 就 是 在 loginSuccess 函数 中 增加 如 下 代码 : 
/ 如 果 勾 选 了 “ 记 住 密码 ”， 则 把 手机 号 码 和 密码 保存 为 数据 库 的 用 户 表 记 录 
if (bRemember) { 
// 创建 一 个 用 户 信息 实体 类 
UserInfo info = new UserInfo(); 
info.phone = et_phone.getText().toString(); 
info.password = et_password.getText().toString(); 
info.update_time = DateUtil.getNowDateTime("yyyy-MM-dd HH:mm:ss"); 
/ 往 用 户 数 据 库 添加 登录 成 功 的 用 户 信息 (包含 手机 号 码 、 密 码 、 登 录 时 间 》 
mHelper.insert(info); 
| 
(3) 再 次 打开 登录 页 面 ， 用 户 输入 手机 号 完毕 后 点 击 密码 输入 框 时 ，App 到 数据 库 中 根 
据 手 机 号 查找 登录 记录 ， 并 将 记录 结果 中 的 密码 填 入 密码 框 。 
看 到 这 里 ， 读 者 也 许 已 经 想到 给 密码 框 注册 点 击 事件 ， 然 后 在 onClick 方法 中 补充 数据 库 
读 取 操 作 。 可 是 EditText 比较 特殊 ， 点 击 后 只 是 让 其 获得 焦点 ， 再 次 点 击 才 会 触发 点 击 事件 。 


让 它 往 东 ， 它 偏偏 往 西 。 难 不 成 叫 用 户 将 就 一 下 点 击 两 次 ? 用 户 肯 定 觉得 这 个 App 古怪 、 难 
变更 监听 器， 比如 下 






面 这 行 代码 : 
/ 给 密码 编辑 框 注册 一 个 焦点 变化 监听 器 ， 一 旦 焦点 发 生变 化 ， 就 触发 监听 器 的 


onFocusChange 方法 
et_password.setOnFocusChangeListener(this); 


这 个 焦点 变更 监听 器 要 实现 接口 OnFocusChangeListener， 对 应 的 事件 处 理 方法 是 
onFocusChange， 将 数据 库 查询 操作 放 在 该 方法 中 ， 详 细 代 码 示例 如 下 : 


// 焦点 变更 事件 的 处 理 方法 ，hasFocus 表示 当前 控件 是 否 获 得 焦点 。 
// 为 什么 光标 进入 密码 框 事件 不 选 onClick? 因为 要 点 两 下 才 会 触发 onClick 动作 (第 一 下 是 切换 
焦点 动作 ) 
@Override 
public void onFocusChange(View V boolean hasFocus) { 
String phone = et phone.getTextO.toStringO; 
/ 判断 是 否 是 密码 编辑 框 发 生 焦点 变化 
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if (v.getId() 一 Ridet password) { 
// 用 户 已 输入 手机 号 码 ， 且 密码 框 获得 焦点 
if (phone.length() > 0 && hasFocus) { 
/ 根据 手机 号 码 到 数据 库 中 查询 用 户 记录 
UserInfo info = mHelper.queryByPhone(phone); 
让 (info !=nulD { 
/ 找到 用 户 记录 ， 则 自动 在 密码 框 中 填写 该 用 户 的 密码 
et_password.setText(info.password); 


| 
这 样 ， 就 不 再 需要 点 击 两 次 才 处 理 点 击 事 件 了 。 
代码 写 完 后 ， 再 来 看 登录 页 面 的 效果 图 ， 用 户 上 次 登录 成 功 时 已 勾 选 “ 记 住 密码 ”，, 现 
在 再 次 进入 登录 页 面 ， 用户 输入 手机 号 后 光标 还 停留 在 手机 框 ， 如 图 4-8 所 示 。 接 着 点 击 密码 
框 ， 光 标 随 之 跳 到 密码 框 ， 这 时 密码 框 自动 填 入 了 该 手机 号 对 应 的 密码 串 ， 如 图 4-9 所 示 。 如 
此 便 真正 实现 了 记 住 密码 功能 。 













@ 密码 登录 〇 验证 码 登录 〇 验证 码 登录 





我 是 : 个 人 用 户 我 是 : 个 人 用 户 


手机 号 码 : L 5960238696| 手机 号 码 ; 15960238696 


登录 密码 ; 忘记 密码 
记 住 密码 








图 4-8 ”光标 在 手机 号 码 框 图 4-9 光标 在 密码 输入 框 


4.3 ”SD 卡 文件 操作 


本 节 介 绍 Android 的 文件 存储 方式 一 一 SD 卡 的 用 法 ， 包 括 如 何 获取 SD 卡 目录 信息 、 公 
有 存储 空间 与 私有 存储 空间 的 区 别 、 在 SD 卡 上 读 写 文本 文件 、 在 SD 卡 读 写 图 片 文件 等 功能 。 


4.3.1 ”SD 卡 的 基本 操作 


手机 的 存储 空间 一 般 分 为 两 块 ， 一 块 用 于 内 部 存储 ， 另 一 块 用 于 外 部 存储 (SD 卡 ) 。 早 
期 的 SD 卡 是 可 插 拔 式 的 存储 芯片 ,不 过 自己 买 的 SD 卡 质量 参差 不 齐 ， 经 常会 影响 App 的 正 
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常 运行 ， 所 以 后 来 越 来 越 多 的 手机 把 SD 卡 


然 称 之 为 外 部 存储 。 





固化 到 手机 内 部 ， 昌 然 拔 不 出 来 ， 但 是 Android 仍 


获取 手机 上 的 SD 卡 信息 通过 Environment 类 实现 ,该 类 是 App 获取 各 种 目录 信息 的 工具 ， 


主要 方法 有 以 下 7 种 。 











egetRootDirectory: 获得 系统 根 目录 的 路 径 。 

。 getDataDirectory: 获得 系统 数据 目录 的 路 径 。 

e@ getDownloadCacheDirectory: 获得 下 载 缓存 目录 的 路 径 。 

e@ getExternalStorageDirectory: 获得 外 部 存储 (SD 卡 ) 的 路 径 。 

e@ ”getExternalStorageState: 获得 SD 卡 的 状态 。 

SD 卡 状态 的 具体 取 值 说 明 见 表 4-1。 

表 4-1 SD 卡 的 存储 状态 取 值 说 明 

Environment 类 的 存储 状态 常量 名 常量 值 常量 说 明 
MEDIA_UNKNOWN unknown 未 知 
MEDIA_REMOVED removed 已 经 移 除 
MEDIA_UNMOUNTED unmounted 未 挂 载 
MEDIA_CHECKING checking 正在 检查 
MEDIA_NOFS nofs 不 支持 的 文件 系统 
MEDIA_MOUNTED mounted 已 经 挂 载 ， 且 是 可 读 写 状态 
MEDIA MOUNTED READ_ONLY mounted_ro 已 经 挂 载 ， 且 是 只 读 状态 
MEDIA_SHARED shared 当前 未 挂 载 ， 但 通过 USB 共享 
MEDIA_BAD REMOVAL bad_removal 未 挂 载 就 被 移 除 
MEDIA_UNMOUNTABLE unmountable 无 法 挂 载 
MEDIA_EJECTING ejecting 正在 弹出 


egetStorageState: 获得 指 
。 getExternalStoragePublicDirectory: 获得 SD 卡 指定 类 型 目录 的 路 径 。 








定 目 录 的 状态 。 




















目录 类 型 的 具体 取 值 说 明 见 表 4-2。 
表 4-2 SD 卡 的 目录 类 型 取 值 说 明 

Environment 类 的 目录 类 型 常量 值 常量 说 明 
DIRECTORY_DCIM DCIM 相片 存放 目录 包括 相机 拍摄 的 图 片 和 视频 ) 
DIRECTORY_DOCUMENTS Documents 文档 存放 目录 
DIRECTORY_DOWNLOADS Download 下 载 文件 存放 目录 
DIRECTORY_MOVIES Movies 视频 存放 目录 
DIRECTORY _ MUSIC Music 音乐 存放 目录 
DIRECTORY _PICTURES Pictures 图 片 存放 目录 








为 正常 操作 SD 卡 ， 需 要 在 AndroidManifestxml 中 声明 SD 卡 的 权限 ， 有 具体 代码 如 下 : 
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<!-- SD 卡 读 写 权 限 -> 

<uses-permission android:name="android.permission. WRITE EXTERNAL STORAGE" /> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAG"/” 
<uses-permission android:name="android.permission.MOUNT _ UNMOUNT FILESYSTEMS" /> 


下 面 演 示 一 下 Environment 类 各 方法 的 使 用 效果 ， 如 图 4-10 所 示 。 页 面 上 展示 了 
Environment 类 获取 到 的 系统 及 SD 卡 的 相关 目录 信息 。 


Storage 


系统 环境 ( 含 SD 卡 ) 的 信息 如 下 : 
根 目录 路 径 ; /system 
数据 目录 路 径 : /data 
下 载 缓存 目录 路 径 : /cache 
外 部 存储 ( 即 SD 卡 ) 目 录 路 径 : /storage/emulated/0 
外 部 存储 ( 即 SD 卡 ) 状 态 : mounted 


SD 卡 的 相机 目录 路 径 : /storage/emulated/0/DCIM 

SD 卡 的 下 载 目录 路 径 : /storage/emulated/0/ 
Download 

SD 卡 的 图 片 目录 路 径 : /storage/emulated/0/ 
Pictures 

SD 卡 的 视频 目录 路 径 : /storage/emulated/0/ 


Movies 
SD 卡 的 音乐 目录 路 径 : /storage/emulated/0/Music 
4-10 某 设备 上 的 SD 卡 目录 信息 
4.3.2 ”公有 存储 空间 与 私有 存储 空间 


本 来 在 AndroidManifest.xml 里 面 配置 了 存储 空间 的 权限 ,代码 就 能 正常 读 写 SD 卡 的 文件 。 
可 是 Android 从 7.0 开始 加 强 了 SD 卡 的 权限 管理 ， 即 使 App 声明 了 完整 的 SD 卡 操作 权限 ， 
系统 仍然 默认 禁止 该 App 访问 外 部 存储 。 打开 7.0 系统 的 设置 界面 , 进入 到 具体 应 用 的 管理 页 
面 ， 会 发 现 应 用 的 存储 功能 被 关闭 了 〈 指 外 部 存储 ) ， 如 图 4-11 所 示 。 





< Storage 


读 写 手机 存储 


这 写 手机 存储 





图 4-11 系统 设置 页 面 里 的 SD 卡 读 写 权限 开关 


不 过 系统 默认 关闭 存储 其 实 只 是 关闭 外 部 存储 的 公共 空间 ， 外 部 存储 的 私有 空间 依然 可 

以 正常 读 写 。 这 是 缘 于 Android 把 外 部 存储 分 成 了 两 块 区 域 ， 一 块 是 所 有 应 用 均 可 访问 的 公共 
室 间 ， 另 一 块 是 只 有 应 用 自己 才 可 访问 的 专 享 空间 。 之 前 讲 过 ,内 部 存储 保存 着 每 个 应 用 的 安 
装 目 录 ， 但 是 安装 目录 的 空间 是 很 紧张 的 ， 所 以 Android 在 SD 卡 的 “Android/data” 目 录 下 给 
每 个 应 用 又 单独 建 了 一 个 文件 目录 , 用 于 给 应 用 保存 自己 需要 处 理 的 临时 文件 。 这 个 给 每 个 应 
用 单独 建立 的 文件 目录 ,只 有 当前 应 用 才能 够 读 写 文件 ， 其 他 应 用 是 不 允许 进行 读 写 的 ,故而 
“Android/data” 目 录 算 是 外 部 存储 上 的 私有 空间 。 这 个 私有 空间 本 身 已 经 做 了 访问 权限 控制 ， 

因此 它 不 受 系统 禁止 访问 的 影响 ,应 用 操作 自己 的 文件 目录 就 不 成 问题 了 。 当 然 , 因为 私有 的 
文件 目录 只 有 属 主 应 用 才能 访问 , 所 以 一 旦 属 主 应 用 被 用 户外 载 , 那么 对 应 的 文件 目录 也 会 一 


第 4 章 数据 存储 | 115 





起 被 清理 掉 。 
既然 外 部 存储 分 成 了 公共 空间 和 私有 空间 两 部 分 ， 这 两 部 分 空间 的 路 径 获 取 也 就 有 所 不 
同 。 获 取 公 共 空 间 的 存储 路 径 ， 调 用 的 是 Environment.getExternalStoragePublicDirectory 方法 ; 
获取 应 用 私有 空间 的 存储 路 径 ， 调 用 的 是 getExternalFilesDir 方法 。 下 面 是 分 别 获取 两 个 空间 
路 径 的 代码 例子 : 
/ 获取 系统 的 公共 存储 路 径 
String publicPath = Environment.getExternalStoragePublicDirectory( 
Environment.DIRECTORY DOWNLOADS).toString(); 
/ 获取 当前 App 的 私有 存储 路 径 
String privatePath = getExternalFilesDir(Environment.DIRECTORY DOWNLOADS).toString0; 
TextView tv_file path = findViewById(R.id.tv_file path); 
String desc= "系统 的 公共 存储 路 径 位 于 " + publicPath + 
"nm 当前 App 的 私有 存储 路 径 位 于 " + privatePath + 
"nnAndroid7.0 之 后 默认 禁止 访问 公共 存储 目录 "; 
tv_file_path.setText(desc); 


该 例子 运行 之 后 获得 的 路 径 信息 如 图 4-12 所 示 ， 可 见 应 用 的 私有 空间 路 径 位 于 “外 部 存 
储 根 目录 /Android/data/ 应 用 包 名 /files/Download” 这 个 目录 之 下 。 
storage 


系统 的 公共 存储 路 径 位 于 /storage/ 
emulated/0/Download 


当前 App 的 私有 存储 路 径 位 于 / 
storage/emulated/0/Android/data/ 
com.example.storageWfiles/Download 


Android7.0 之 后 默认 禁止 访问 公共 存储 目录 





图 4-12 公共 存储 与 私有 存储 的 各 自 目录 路 径 
4.3.3 ”文本 文件 读 写 


文本 文件 的 读 写 一 般 借 助 于 FileOutputStream 和 FileInputStream。 其 中 ，FileOutputStream 
用 于 写 文件 ，FileInputStream 用 于 读 文 件 。 文 件 输出 输入 流 是 Java 语言 的 基础 工具 ， 这 里 不 
再 歼 述 ， 直 接 给 出 具体 的 实现 代码 : 


/ 把 字符 串 保存 到 指定 路 径 的 文本 文件 
public static void saveText(String path, String txt) { 
try{ 
FileOutputStream fos = new FileOutputStream(path); / 根据 路 径 构建 文件 输出 流 对 象 
fos.write(txt.getBytes()); / 把 字符 串 写 入 文件 输出 流 
fos.close(); / 关闭 文件 输出 流 
} catch (Exception e) { 
e.printStack Trace(); 
上 
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} 


// 从 指定 路 径 的 文本 文件 中 读 取 内 容 字符 串 
public static String openText(String path) { 
String readStr = ""; 
try{ 
FileInputStream fis = new FileInputStream(path); / 根据 路 径 构建 文件 输入 流 对 象 
byte[] b= new byte[fis.available()]; 
fsread(b); / 从 文件 输入 流 读 取 字 节 数 组 
readStr = new String(b); / 把 字 节 数组 转换 为 字符 串 
fis.close0; / 关闭 文件 输入 流 
} catch (Exception e) { 
e.printStackTrace(); 
': 
Teturn readStr; // 返回 文本 文件 中 的 文本 字符 串 


} 
文本 文件 的 读 写 效果 如 图 4-13 所 示 ， 此 时 App 把 注册 信息 保存 到 SD 卡 的 文本 文件 中 。 
接着 进入 文件 列表 读 取 页 面 ， 选 中 某 个 文件 ， 页 面 就 展示 该 文件 的 文本 内 容 ， 如 图 4-14 所 示 。 


storage 





删除 所 有 文本 文件 


文件 名 : 20180523163753.txt 过 
文件 内 容 如 下 ; 








婚 否 : 已 婚 
注册 时 间 : 2018-05-23 16:37:53 





保存 文本 到 SD 卡 


用 户 注册 信息 文件 的 保存 路 径 为 ; 
/storage/emulated/0/Android/data/ 
com.example.storage/files/Download/ 
20180523163753.txt 











4-13 将 注册 信息 保存 到 文本 文件 图 4-14 从 文本 文件 读 取 注 册 信 息 
4.3.4 图 片 文件 读 写 
Android 的 图 片 处 理 类 是 Bitmap，App 读 写 Bitmap 可 以 使 用 FileOutputStream 和 
FileInputStream。 不 过 在 实际 开发 中 ， 读 写 图 片 文件 一 般 用 性 能 更 好 的 BufferedOutputStream 
和 BufferedInputStream。 
保存 图 片 文件 时 用 到 Bitmap 的 compress 方法 ,可 指定 图 片 类 型 和 压缩 质量 ; 打开 图 片 文 
件 时 使 用 BitmapFactory 的 decodeStream 方法 。 读 写 图 片 的 具体 代码 如 下 : 
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/ 把 位 图 数据 保存 到 指定 路 径 的 图 片 文件 
public static void saveImage(String path, Bitmap bitmap) { 
try{ 
/ 根据 指定 文件 路 径 构建 缓存 输出 流 对 象 
BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(path)); 
/ 把 位 图 数据 压缩 到 缓存 输出 流 中 
bitmap.compress(Bitmap.CompressFormatJPEG, 80, bos); 
/ 完成 缓存 输出 流 的 写 入 动作 
bos.flush(); 
// 关闭 缓存 输出 流 
bos.close(); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
1 


// 从 指定 路 径 的 图 片 文件 中 读 取 位 图 数据 
public static Bitmap openImage(String path) { 
Bitmap bitmap = null; 


上 
/ 根据 指定 文件 路 径 构建 缓存 输入 流 对 象 
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(path)); 
// 从 缓存 输入 流 中 解码 位 图 数据 
bitmap = BitmapFactory.decodeStream(bis); 
bis.close();， // 关闭 缓存 输入 流 
} catch (Exception e) { 
e.printStack Trace(); 
B 
/ 返回 图 片 文件 中 的 位 图 数据 
return bitmap; 
由 
接 下 来 是 演示 时 间 ， 如 图 4-15 所 示 ， 用 户 在 注册 页 面 录入 注册 信息 ，App 调用 
getDrawingCache 方法 把 整个 注册 界面 截图 并 保存 到 SD 卡 ; 然后 在 另 一 个 页 面 的 图 片 列表 选 
择 SD 卡 上 的 指定 图 片 文件 ， 页 面 就 会 展示 上 次 保存 的 注册 界面 图 片 ， 如 图 4-16 所 示 。 
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Storage storage 
姓名 : Lucy 删除 所 有 图 片 文件 
年 龄 :25 文件 名 : 20180523163842.png = 
身高 : 165 姓名 : Lucy 
体重 : |50 年 龄 : 25 
婚 否 : 未 婚 ~ 身高 : 165 
保存 图 片 到 SD 卡 体重 : |50 
用 户 注册 信息 图 片 的 保存 路 径 为 : 
/storage/emulated/0/Android/data/ 婚 否 : 未 婚 
com.example.storage/files/Download/ 
20180523163842.png 
图 4-15 保存 注册 信息 图 片 4-16 读 取 注册 信息 图 片 


刚才 从 SD 卡 读 取 图 片 文件 用 到 了 BitmapFactory 的 decodeStream 方法 , 其 实 BitmapFactory 
还 提供 了 其 他 方法 ， 用 起 来 更 简单 、 方 便 ， 说 明 如 下 : 
e。 decodeFile: 该 方法 直接 传 文件 路 径 的 字符 串 ， 即 可 将 指定 路 径 的 图 片 读 取 到 Bitmap 对 
象 。 
@ decodeResource: 该 方法 可 从 资源 文件 中 读 取 图 片 信息 。 第 一 个 参数 一 般 传 
getResources()， 第 二 个 参数 传 drawable 图 片 的 资源 id， 如 R.drawable.phone。 


4.4 应 用 Application 基础 


本 节 介绍 Android 重要 组 件 Application 的 基本 概念 和 常见 用 法 。 首 先 说 明 Application 的 
生命 周期 ， 接 着 利用 Application 的 持久 特性 实现 App 内 部 全 局 内 存 中 的 数据 保存 和 获取 。 
4.4.1 Application 的 生命 周期 

Application 是 Android 的 一 大 组 件 ， 在 App 运行 过 程 中 有 且 仅 有 一 个 Application 对 象 贯 
穿 整个 生命 周期 ,打开 AndroidManifestxml 时 会 发 现 activity 节点 的 上 级 正 是 application 节点 ， 
只 是 默认 的 application 节点 没有 指定 name 属性 ， 不 像 activity 节点 默认 指定 name 属性 值 
为 .MainActivity, 让 人 知晓 这 个 activity 的 入 口 代码 是 MainActivity.java。 现 在 试 试 给 application 
节点 加 上 name 属性 ， 看 看 其 庐山 真面目 。 


(1) 打开 AndroidManifest.xml， 给 application 节点 加 上 name 属性 ， 表 示 application 的 
入 口 代码 是 MainApplication.java。 


android:name=".MainApplication" 
(2) 创建 MainApplication 类 , 该 类 继承 自 Application, 可 以 重 写 的 方法 主要 有 以 下 4 个 。 





onCreate: 在 App 启动 时 调用 。 

onTerminate: 在 App 退出 时 调用 ( 按 字面 意思 ) 。 

onLowMemory: 在 低 内 存 时 调用 。 

onConfigurationChanged: 在 配置 改变 时 调用 ， 例 如 从 坚 屏 变 为 横 屏 。 


(3) 运行 App， 同 时 开启 日 志 的 打印 。 但 是 只 在 一 开始 看 到 MainApplication 的 onCreate 
操作 〈 先 于 Activity 的 onCreate) ， 却 始终 无 法 看 到 它 的 onTerminate 操作 ， 无 论 是 自行 退出 
还 是 强行 杀 死 App 的 进程 ， 日 志 都 不 会 打印 onTerminate。 


无 论 你 怎么 折腾 ， 这 个 onTerminate 都 不 会 出 来 。Android 明明 提供 了 这 个 函数 ， 同 时 提 
供 了 关于 该 函数 的 解释 , 说 明文 字 如 下 : This method is for use in emulated process environments. 
It will never be called on a production Android device，where processes are removed by simply 
killing them: no user code (including this callback) is executed when doing so。 这 段 话 的 意思 是 该 
方法 是 供 模拟 环境 用 的 ， 在 真 机 上 永远 不 会 被 调用 ， 无 论 是 直接 杀 进 程 还 是 代码 退出 。 
现在 很 明确 了 ，onTerminate 方法 就 是 个 摆设 ， 中 看 不 中 用 。 如 果 读 者 想 在 App 退出 前 做 
资源 回收 操作 ， 那 么 千 万 不 要 放 在 onTerminate 方法 中 。 


4.4.2 利用 Application 操作 全 局 变量 


C/C++ 有 全 局 变量 ， 因 为 全 局 变量 保存 在 内 存 中 ， 所 以 操作 全 局 变量 就 是 操作 内 存 ， 内 存 
的 读 写 速度 远 比 读 写 数据 库 或 读 写 文件 快 得 多 。 全 局 的 意思 是 其 他 代码 都 可 以 引用 该 变量 , 因 
此 全 局 变量 是 共享 数据 和 消息 传递 的 好 帮手 。 不 过 ，Java 没有 全 局 变量 的 概念 。 与 之 比较 接 
近 的 是 类 里 面 的 静态 成 员 变 量 , 该 变量 可 被 外 部 直接 引用 , 并 且 在 不 同 地 方 引用 的 值 是 一 样 的 

(前 提 是 在 引用 期 间 不 能 修改 该 变量 的 值 ), 所 以 可 以 借助 静态 成 员 变量 实现 类 似 全 局 变量 的 

功能 。 

前 面 花费 很 大 功夫 介绍 Application 的 生命 周期 ， 目 的 是 说 明 其 生命 周期 覆盖 App 运行 的 
全 过 程 。 不 像 短 暂 的 Activity 生命 周期 ， 只 要 进入 别 的 页 面 ， 原 页 面 就 被 停止 或 销毁 。 因 此 ， 
通过 利用 Application 的 持久 存在 性 可 以 在 Application 对 象 中 保存 全 局 变量 。 

适合 在 Application 中 保存 的 全 局 变量 主要 有 下 面 3 类 数据 : 


(1) 会 频繁 读 取 的 信息 ， 如 用 户 名 、 手 机 号 等 。 

(2) 从 网 络 上 获取 的 临时 数据 ， 为 节约 流量 、 减 少 用 户 等 待 时 间 ， 想 暂时 放 在 内 存 中 供 
下 次 使 用 ， 如 logo、 商 品 图 片 等 。 

(3) 容易 因 频 繁 分 配 内 存 而 导致 内 存 泄 漏 的 对 象 ， 如 Handler 对 象 等 。 


要 想 通 过 Application 实现 全 局 内 存 的 读 写 ， 得 完成 以 下 3 项 工作 : 


(1) 写 一 个 继承 自 Application 的 类 MainApplication。 该 类 要 采用 单 例 模式 ， 内 部 声明 自 
身 类 的 一 个 静态 成 员 对 象 ， 在 创建 App 时 把 自身 赋值 给 这 个 静态 对 象 ， 然 后 提供 该 静态 对 象 
的 获取 方法 getInstance。 

(2) 在 Activity 中 调用 MainApplication 的 getInstance 方法 ， 获 得 MainApplication 的 一 
个 静态 对 象 ， 通 过 该 对 象 访问 MainApplication 的 公共 变量 和 公共 方法 。 

(3) 不 要 忘 了 在 AndroidManifestxml 中 注册 新 定义 的 Application 类 名 ， 即 在 application 
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节点 中 增加 android:name 属性 ， 值 为 .MainApplication 。 

F 面 继续 演示 全 局 内 存 的 读 写 效果 ， 如 图 4-17 所 示 。App 把 注册 信息 保存 到 
MainApplication 的 全 局 变量 中 ， 然 后 在 另 一 个 页 面 从 MainApplication 的 全 局 变量 中 读 取保 存 
好 的 注册 信息 ， 如 图 4-18 所 示 。 












Storage storage 


全 局 内 存 中 保存 的 信息 如 下 : 
married 的 取 值 为 未 婚 
height 的 取 值 为 170 
name 的 取 值 为 小 明 
age 的 取 值 为 18 
weight 的 取 值 为 60 
Update_time 的 取 值 为 2018-05-23 

16:40:52 











保存 到 全 局 内 存 











4-17 注册 信息 保存 到 全 局 内 存 图 4-18 ”从 全 局 内 存 读 取 注册 信息 
下 面 是 自 定义 MainApplicaton 类 的 代码 框架 : 
public class MainApplication extends Application { 
/ 声明 一 个 当前 应 用 的 静态 实例 
private static MainApplication mApp; 


// 声明 一 个 公共 的 信息 映射 ， 可 当 作 全 局 变量 使 用 
public Hash Map<String, String> mInfoMap = new Hash Map<String, String>(); 


/ 利用 单 例 模式 获取 当前 应 用 的 唯一 实例 
public static MainApplication getInstance() { 


return mApp; 
(@Override 
public void onCreate() { 
super.onCreate(); 
/ 在 打开 应 用 时 对 静态 的 应 用 实例 赋值 
mApp = this; 
} 


} 


完成 以 上 编码 后 ，Activity 页 面 代码 即 可 直接 通过 MainApplication.getInstance().mInfoMap 
对 全 局 变量 进行 增 、 删 、 改 、 查 操作 。 





4.5 内 容 提供 与 处 理 


本 节 介绍 Android 四 大 组 件 之 一 的 ContentProvider 的 基本 概念 和 常见 用 法 ,首先 说 明 如 何 
使 用 内 容 提 供 器 封装 数据 的 外 部 访问 接口 ;接着 曾 述 如 何 通过 内 容 解析 器 在 外 部 查询 和 修改 数 
据 , 以 及 使 用 内 容 操 作 器 完成 批量 数据 操作 ; 然后 说 明 内 容 观察 器 的 应 用 场合 ,并 演示 如 何 借 
助 内 容 观察 器 实现 流量 校准 的 功能 。 


4.5.1 内 容 提供 器 ContentProvider 


Android 号 称 提供 了 4 大 组 件 ， 分 别 是 页 面 Activity、 广 播 Broadcast、 服 务 Service 和 内 容 
提供 器 ContentProvider。 其 中 内 容 提供 器 是 跟 数据 存 取 有 关 的 组 件 , 完整 的 内 容 组 件 由 内 容 提 
供 器 ContentProvider、 内 容 解析 器 ContentResolver、 内 容 观察 器 ContentObserver 这 三 部 分 组 
成 。 

ContentProvider 为 App 存 取 内 部 数据 提供 统一 的 外 部 接口 ， 让 不 同 的 应 用 之 间 得 以 共享 
数据 。 像 我 们 熟知 的 SQLite 操作 的 是 应 用 自身 的 内 部 数据 库 ， 文件 的 上 传 和 下 载 操作 的 是 后 
端 服务 器 的 文件 ， 而 ContentProvider 操作 的 是 本 设备 其 他 应 用 的 内 部 数据 ， 是 一 种 中 间 层 次 
的 数据 存储 形式 。 

在 实际 编码 中 ，ContentProvider 只 是 一 个 服务 端的 数据 存 取 接口 ,开发 者 需要 在 其 基础 上 
实现 一 个 具体 类 ， 并 重 写 以 下 相关 数据 库 管 理 方法 。 


onCreate: 创建 数据 库 并 获得 数据 库 连 接 。 
query: 查询 数据 。 

insert: 插入 数据 。 

update: 更 新 数据 。 

delete: 删除 数据 。 

getType: 获取 数据 类 型 。 


这 些 方法 看 起 来 是 不 是 很 像 SQLite? 没 错 ，ContentProvider 作为 中 间接 口 ， 本 身 并 不 直 
接 保存 数据 ， 而 是 通过 SQLiteOpenHelper 与 SQLiteDatabase 间接 操作 底层 的 SQLite。 所 以 要 
想 使 用 ContentProvider， 首 先 得 实现 SQLite 的 数据 表 帮 助 类 ， 然 后 由 ContentProvider 封装 对 
外 的 接口 。 

下 面 是 使 用 ContentProvider 提供 用 户 信息 对 外 接口 的 代码 : 


public class UserInfoProvider extends ContentProvider { 
private UserDBHelper userDB; ”// 声明 一 个 用 户 数据 库 的 帮助 器 对 象 
public static final int USER_INFO = 1; // Uri 匹配 时 的 代号 
public static final UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH); 
static { / 往 Uri 匹配 器 中 添加 指定 的 数据 路 径 
uriMatcher.addURI(UserInfoContent.AUTHORITIES, Wuser", USER_INFO); 
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} 


/ 根据 指定 条 件 删除 数据 
public int delete(Uri uri, String selection, String[] selectionArgs) { 
int count = 0; 
if (uriMatcher.match(uri) 一 USER INFO) { 
// 获取 SQLite 数据 库 的 写 连 接 
SQLiteDatabase db = userDB.getWritableDatabase(); 
// 执行 SQLite 的 删除 操作 ， 返 回 删除 记录 的 数目 
count = db.delete(UserInfoContent.TABLE_ NAME, selection, selectionArgs); 
db.close0; / 关闭 SQLite 数据 库 连接 
} 
return count; 


// 插入 数据 
public Uri insert(Uri uri, ContentValues values) { 
Uri newUri = uri; 
if (uriMatcher.match(uri) 一 USER_INFO) { 
// 获取 SQLite 数据 库 的 写 连接 
SQLiteDatabase db = userDB.getWritableDatabase(); 
// 向 指定 的 表 插入 数据 ， 返 回 记 录 的 行 号 
long rowId = db.insert(UsermfoContenLTABLE NAME,null values); 
if(rowId> 0){ // 判断 插入 是 否 执行 成 功 
/ 如 果 添 加 成 功 ， 利 用 新 记录 的 行 号 生成 新 的 地 址 
newUri = ContentUris.withAppendedIld(UserInfoContent.CONTENT_URI, rowlId); 
/ 通知 监听 器 ， 数 据 已 经 改变 
getContext().getContentResolver().notifyChange(newUri, null); 
} 
db.close(); / 关闭 SQLite 数据 库 连 接 
return uri; 


’ 


// 创建 ContentProvider 时 调用 ， 可 在 此 获取 具体 的 数据 库 帮 助 器 实例 
public boolean onCreate() { 

userDB = UserDBHelper.getInstance(getContext(), 1); 

return false; 


} 


/ 根据 指定 条 件 查询 数据 库 
public Cursor query(Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 





Cursor cursor = null; 
if (uriMatcher.match(uri) 一 USER_INFO) { 
// 获取 SQLite 数据 库 的 读 连 接 
SQLiteDatabase db = userDB.getReadableDatabase(); 
// 执行 SQLite 的 查询 操作 
cursor = db.query(UserInfoContent.TABLE NAME, 
Pprojection, selection, selectionArgs, null, null, sortOrder); 
/ 设置 内 容 解析 器 的 监听 
cursor.setNotificationUri(getContext().getContentResolver(), uri); 
} 


return cursor; 


} 


/ 获取 Uri 数据 的 访问 类 型 ， 暂 未 实现 
public String getType(Uri uri) {} 


// 更 新 数据 ， 暂 未 实现 
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {} 
既然 内 容 提 供 器 是 四 大 组 件 之 一 ， 就 得 在 AndroidManifest.xml 中 注册 它 的 定义 ， 并 开放 
外 部 访问 权限 ， 注 册 代码 如 下 : 
<provider 

android:name=".provider.UserInfoProvider" 
android:authorities="com.example.storage.provider.UserInfoProvider" 
android:enabled="true" 
android:exported="true" 亡 


注册 完毕 后 就 完成 了 服务 端 App 的 封装 工作 ， 接 下 来 可 由 其 他 App 进行 数据 存 取 。 
4.5.2 内容 解析 器 ContentResolver 


前 面 提 到 了 利用 ContentProvider 实现 服务 端 App 的 数据 封装 ， 如 果 客 户 端 App 想 访问 对 
方 的 内 部 数据 ， 就 要 通过 内 容 解析 器 ContentResolver 访问 。 内 容 解析 器 是 客户 端 App 操作 服 
务 端 数据 的 工具 ， 相 对 应 的 内 容 提供 器 是 服务 端的 数据 接口 。 要 获取 ContentResolver 对 象 ， 
在 Activity 代码 中 调用 getContentResolver 方法 即 可 。 

ContentResolver 提供 的 方法 与 ContentProvider 是 一 一 对 应 的 ， 比 如 query、insert、update、 
delete、getType 等 方法 ， 连 方法 的 参数 类 型 都 一 模 一 样 。 其 中 ， 最 常用 的 是 query 函数 ， 调 用 
该 函数 返回 一 个 游标 Cursor 对 象 ， 这 个 游标 与 SQLite 的 游标 是 一 样 的 ， 想 必 读 者 早已 用 得 炉 
火 纯 青 。 

下 面 是 query 方法 的 具体 参数 说 明 〈 依 顺序 排列 ) 。 


euri: Uri 类 型 ， 可 以 理解 为 本 次 操作 的 数据 表 路 径 。 
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projection: 字符 串 数 组 类 型 ， 指 定 将 要 查询 的 字段 名 称 列表 。 
selection: 字符 串 类 型 ， 指 定 查询 条 件 。 

selectionArgs: 字符 串 数 组 类 型 ， 指 定 查询 条 件 中 的 参数 取 值 列表 。 
sortOrder: 字符 串 类 型 ， 指 定 排序 条 件 。 


针对 前 面 UserInfoProvider 提供 的 数据 接口 , 下 面 使 用 ContentResolver 在 客户 端 添加 用 户 
信息 ， 代 码 如 下 : 
/ 添加 一 条 用 户 记录 
private void addUser(ContentResolver resolver UserInfo user) { 


ContentValues name = new ContentValues(); 
name.put("name", user.name); 





name.put("age", user.age); 

name.put("height", user.height); 

name.put("weight", user.weight); 

name.put("married", false); 

name.put("update_time", DateUtil.getNowDateTime("")); 

// 通过 内 容 解析 器 往 指定 Uri 中 添加 用 户 信息 

Tesolverinsert(UserInfoContenLCONTENT_URI, name); 
| 


下 面 是 使 用 ContentResolver 在 客户 端 查询 所 有 用 户 信 息 的 代码 : 


/ 读 取 所 有 的 用 户 记录 
private String readAllUser(ContentResolver resolver) { 

ArrayList<UserInfo> userArray = new ArrayList<UserInfo>(); 

// 通过 内 容 解析 器 从 指定 Uri 中 获取 用 户 记录 的 游标 

Cursor cursor = resolver.query(UserImfoContenLCONTENT_URI null, null, null nulD); 

/ 循环 取出 游标 指向 的 每 条 用 户 记录 

while (cursor.moveToNext()) { 
UserInfo user = new UserInfo(); 
username = cursor.getString(cursor.getColumnIndex(UserInfoContent.USER_NAME)); 
User.age = cursor.getInt(cursor.getColumnIndex(UserInfoContent.USER_AGE)); 
user.height = cursor.getInt(cursor.getColumnIndex(UserInfoContent.USER_HEIGHT)); 
User.weight = cursor.getFloat(cursor.getColumnIndex(UserInfoContent.USER_WEIGHT)); 
userArray.add(user); / 添加 到 用 户 信息 队列 

b 

cursor.close(); // 关闭 数据 库 游 标 

String result = ""; 

for (UserInfo user : userArray) { 
// 遍历 用 户 信息 队列 ， 逐 个 拼接 到 结果 字符 串 
result = String.format("%s%s 年龄 %d 身高 %d 体重 %f\n", result, 

user.name, user.age, user.height, user.weight); 


Teturn result; 


第 4 章 数据 存储 | 125 





} 
添加 用 户 信息 的 效果 如 图 4-19 所 示 ， 一 开始 服务 端的 用 户 表 不 存在 用 户 记录 ， 客 户 端 使 
用 ContentResolver 添加 一 条 记录 后 ， 服 务 端的 用 户 记 录 数 返回 1。 用 户 信息 的 查询 明细 如 图 
4-20 所 示 ， 点 击 页 面 上 的 用 户 记 录 数 量 文字 ， 弹 出 一 个 对 话 框 ， 提 示 当 前 找到 的 所 有 用 户 的 
明细 数据 ， 包 括 姓名 、 年 龄 、 身 高 、 体 重 等 信息 。 





Storage 


当前 共 找到 1 位 用 户 信息 





阿 四 年 龄 25 身高 165 体重 


50.000000 








添加 用 户 信息 
当前 共 找到 1 位 用 户 信息 








图 4-19 利用 内 容 提供 器 添加 用 户 信息 图 4-20 利用 内 容 解析 器 查询 获得 用 户 信息 


在 实际 开发 中 ， 普 通 App 很 少 会 开放 数据 接口 给 其 他 应 用 访问 ， 作 为 服务 端 接口 的 
ContentProvider 基本 用 不 到 。 内 容 组 件 能 够 派 上 用 场 的 情况 往往 是 App 想 要 访问 系统 应 用 的 
通信 数据 ， 比 如 查看 联系 人 、 短 信 、 通 话 记录 ， 以 及 对 这 些 通 \ 进 行 增 、 删 、 改 、 查 。 

下 面 是 使 用 ContentResolver 添加 联系 人 信息 的 代码 片段 ， 此 时 访问 的 数据 来 源 变 成 了 系 
统 自 带 的 raw_contacts: 


// 往 手机 中 添加 一 个 联系 人 信息 包括 姓名 、 电 话 号 码 、 电 子 邮 箱 ) 
public static void addContacts(ContentResolver resolver, Contact contact) { 
/ 构建 一 个 指向 系统 联系 人 提供 器 的 Uri 对 象 
Uri raw_uri = Uri.parse("content://com.android.contacts/raw_contacts"); 
/ 创建 新 的 配对 
ContentValues values = new ContentValues(); 
/ 往 raw_contacts 中 添加 联系 人 记录 ， 并 获取 添加 后 的 联系 人 编号 
long contactld = ContentUris.parseld(resolver.insert(raw_uri, values)); 
/ 构建 一 个 指向 系统 联系 人 数据 的 Uri 对 象 
Uri uri = Uri.parse("content://com.android.contacts/data”); 
/ 创建 新 的 配对 
ContentValues name = new ContentValues(); 
// 往 配 对 中 添加 联系 人 编号 
name.put("raw_contact_id", contactId); 
/ 往 配对 中 添加 数据 类 型 为 “姓名 ” 
name.put("mimetype", "vnd.android.cursor.item/name"); 
/ 往 配对 中 添加 联系 人 的 姓名 
name.put("data2", contact.name); 
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/ 往 data 中 添加 联系 人 的 姓名 
resolver.insert(uri, name); 

/ 创建 新 的 配对 

ContentValues phone = new ContentValues(); 
/ 往 配 对 中 添加 联系 人 编号 
phone.put("raw_contact id", contact[d); 

/ 往 配对 中 添加 数据 类 型 为 “电话 号 码 ” 
phone.put("mimetype", "vnd.android.cursor.item/phone_v2"); 
phone.put("data2", "2"); 

/ 往 配对 中 添加 联系 人 的 电话 号 码 
phone.put("datal", contact.phone); 

/ 往 data 中 添加 联系 人 的 电话 号 码 
resolver.insert(uri, phone); 

/ 创建 新 的 配对 

ContentValues email = new ContentValues(); 
/ 往 配对 中 添加 联系 人 编号 
email.put("raw_contact_id", contactId); 

/ 往 配 对 中 添加 数据 类 型 为 “电子 邮箱 ” 
email.put("mimetype", "vnd.android.cursor.item/email_v2"); 
email.put("data2", "2"); 

/ 往 配 对 中 添加 联系 人 的 电子 邮箱 
email.put("datal", contact.email); 

/ 往 data 中 添加 联系 人 的 电子 邮箱 
resolver.insert(uri, email); 


| 


注意 上 述 代码 用 了 4 条 insert 语句 ， 但 业务 上 只 添加 了 一 个 联系 人 信息 。 这 样 处 理 有 一 个 
问题 ， 就 是 4 个 insert 操作 不 在 同一 个 事务 中 ， 要 是 中 间 某 步 insert 操作 失败 ， 那 么 之 前 插入 
成 功 的 记录 就 无 法 自动 回 深 ， 从 而 产生 垃圾 数据 。 

为 了 避免 这 种 情况 的 发 生 , Android 提供 了 内 容 操作 器 ContentProviderOperation 进行 批量 
数据 的 处 理 ， 即 在 一 个 请 求 中 封装 多 条 记录 的 修改 动作 , 然后 一 次 性 提交 给 服务 端 ， 从 而 实现 
在 一 个 事务 中 完成 多 条 数据 的 更 新 操作 。 即 使 某 条 记录 处 理 失 败 ，ContentProviderOperation 也 
能 根据 事务 一 致 性 原则 自动 回 滚 本 事务 已 经 执行 的 修改 操作 。 

下 面 是 使 用 ContentProviderOperation 批量 添加 联系 人 信息 的 代码 片段 : 
// 往 手机 中 一 次 性 添加 一 个 联系 人 信息 (包括 主 记录 、 姓 名 、 电 话 号 码 、 电 子 邮 箱 ) 
public static void addFullContacts(ContentResolver resolver, Contact contact) { 
// 构建 一 个 指向 系统 联系 人 提供 器 的 Uri 对 象 
Uri raw_uri = Uri.parse("content://com.android.contacts/raw_contacts"); 
// 构建 一 个 指向 系统 联系 人 数据 的 Uri 对 象 
Uri uri = Uri.parse("content://com.android.contacts/data”); 
/ 创建 一 个 插入 联系 人 主 记录 的 内 容 操作 器 
ContentProviderOperation op_main = ContentProviderOperation 
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-newInsert(raw_uri).withValue("account name", null).build(); 
/ 创建 一 个 插入 联系 人 姓名 记录 的 内 容 操作 器 
ContentProviderOperation op_name = ContentProviderOperation 
newlInsert(uri).withValueBackReference("raw_contact id", 0) 
.withValue("mimetype", "vnd.android.cursor.item/name") 
.withValue("data2", contact.name).build(); 
/ 创建 一 个 插入 联系 人 电话 号 码 记录 的 内 容 操作 器 
ContentProviderOperation op_phone = ContentProviderOperation 
newInsert(uri).withValueBackReference("raw_contact id", 0) 
.withValue("mimetype", "vnd.android.cursor.item/phone_v2") 
.withValue("data2", "2").withValue("datal", contact.phone).build(); 
/ 创建 一 个 插入 联系 人 电子 邮箱 记录 的 内 容 操作 器 
ContentProviderOperation op_email = ContentProviderOperation 
.newlInsert(uri).withValueBackReference("raw_contact id", 0) 
.withValue("mimetype", "vnd.android.cursor.item/email_v2") 
.withValue("data2", "2").withValue("datal", contact.email).build(); 
// 声明 一 个 内 容 操作 器 的 队列 ， 并 将 上 面 四 个 操作 器 添加 到 该 队列 中 
ArrayList<ContentProviderOperation> operations = new ArrayList<ContentProviderOperation>(); 
operations.add(op_main); 
operations.add(op_name); 
operations.add(op_phone); 
operations.add(op_email); 
try{ 
/ 批量 提交 四 个 内 容 操作 器 所 做 的 修改 
resolver.applyBatch("com.android.contacts", operations); 
} catch (Exception e) { 
e.printStack Trace(); 


1 


添加 联系 人 信息 的 效果 如 图 4-21 和 图 4-22 所 示 。 其 中 ， 图 4-21 所 示 为 添加 之 前 的 截图 ， 
此 时 联系 人 个 数 为 157 位 ; 图 4-22 所 示 为 添加 成 功 之 后 的 截图 ， 此 时 联系 人 个 数 为 158 位 。 





storage storage 

联系 人 姓名 : 。 阿 四 联系 人 姓名 : ”| 阿 四 

联系 人 手机 号 :15960238696 联系 人 手机 号 : 15960238696 
添加 联系 人 添加 联系 人 

当前 共 找到 177 位 联系 人 当前 共 找 到 178 位 联系 人 








图 4-21 联系 人 添加 之 前 的 界面 图 4-22 联系 人 添加 之 后 的 界面 
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4.5.3 内容 观 察 器 ContentObserver 


ContentResolver 获取 数据 采用 的 是 主动 查询 方式 , 有 查询 就 有 数据 , 没 查询 就 没 数据 。 有 
时 我 们 不 但 要 获取 以 往 的 数据 ， 还 要 实时 获取 新 增 的 数据 ， 最 常见 的 业务 场景 是 短信 验证 码 。 
电 商 App 经 常 在 用 户 注册 或 付款 时 发 送 验证 码 短信 ， 为 了 给 用 户 省 事 ，App 通常 会 监控 手机 
刚 收 到 的 验证 码 数字 ， 并 自动 填 入 验证 码 输 入 框 。 这 时 就 用 到 了 内 容 观察 器 ContentObserver， 
给 目标 内 容 注 册 一 个 观察 器 ， 目 标 内 容 的 数据 一 旦 发 生变 化 ， 观 察 器 规定 好 的 动作 马上 和 触发， 
从 而 执行 开发 者 预先 定义 的 代码 。 

内 容 观察 器 的 用 法 与 内 容 提供 器 类 似 ， 也 要 从 ContentObserver 派生 一 个 观察 器 类 ， 然 后 
通过 ContentResolver 对 象 调用 相应 的 方法 注册 或 注销 观察 器 。 下 面 是 ContentResolver 与 观察 
器 有 关 的 方法 说 明 。 

e@ registerContentObserver: 注册 内 容 观察 器 。 

e@ unregisterContentObserver: 注销 内 容 观察 器 。 

e@ notifyChange: 通知 内 容 观察 器 发 生 了 数据 变化 。 


为 了 让 读者 更 好 理解 ， 下 面 举 一 个 实际 应 用 的 例子 。 手 机 号 码 的 每 月 流量 限额 一 般 由 用 
户 手动 配置 , 但 流量 限额 其 实 是 由 移动 运营 商 指 定 的 。 以 中 国 移动 为 例 ， 只 要 发 送 流量 校准 短 
信 给 运营 商 客 服 号 码 〈 如 发 送 18 到 10086) ， 运 营 商 就 会 给 用 户 发 送 本 月 的 流量 数据 ， 包 括 
月 流量 额度 、 已 使 用 流量 、 未 使 用 流量 等 信息 。 手 机 App 只 需 监 控 10086 发 送 的 短信 内 容 ， 
即 可 自动 获取 手机 号 码 的 月 流量 额度 ， 无 须 用 户 手工 配置 。 
下 面 是 利用 ContentObserver 实现 流量 校准 的 代码 片段 : 
private Handler mHandler = new Handler0; V/ 声明 一 个 处 理 器 对 象 
private SmsGetObserver mObserver; / 声明 一 个 短信 获取 的 观察 器 对 象 
private static Uri mSmsUri; / 声明 一 个 系统 短信 提供 器 的 Uri 对 象 
private static String[] mSmsColumn; / 声明 一 个 短信 记录 的 字段 数组 


/ 初始 化 短信 观察 器 
private void initSmsObserver() { 
mSmsUri = Uri.parse("content://sms"); 
mSmsColumn = new String[]{"address", "body", "date"}; 
/ 创建 一 个 短信 观察 器 对 象 
mObserver = new SmsGetObserver(this, mHandler); 
/ 给 指定 Uri 注册 内 容 观察 器 ， 一 旦 Uri 内 部 发 生 数据 变化 ， 就 触发 观察 器 的 onChange 方法 
getContentResolver().registerContentObserver(mSmsUri, true, mObserver); 
} 


// 在 页 面 销 毁 时 触发 

protected void onDestroy() { 
/ 注销 内 容 观察 器 
getContentResolver().unregisterContentObserver(mObserver); 
super.onDestroy(); 
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/ 定义 一 个 短信 获取 的 观察 器 
Private static class SmsGetObserver extends ContentObserver { 
private Context mContext; // 声明 一 个 上 下 文 对 象 
public SmsGetObserver(Context context, Handler handler) { 
super(handler); 
mContext = context; 


} 


/ 观察 到 短信 的 内 容 提 供 器 发 生变 化 时 触发 
public void onChange(boolean selfChange) { 
String sender = "", content = ""; 
// 构建 一 个 查询 短信 的 条 件 语句 ， 这 里 使 用 移动 号 码 测试 ， 故 而 查找 10086 发 来 的 短信 
String selection = String.format("address="10086' and date>%d", System.currentTimeMillis() - 
1000 * 60 * 60); 
// 通过 内 容 解析 器 获取 符合 条 件 的 结果 集 游标 
Cursor cursor = mContext.getContentResolver().query( 
mSmsUri, mSmsColumn, selection, null, " date desc"); 
/ 循环 取出 游标 所 指向 的 所 有 短信 记录 
while (cursormoveToNextO) { 
sender = cursor.getString(0); 
content = cursor.getString( 1); 
break; 
} 
cursor.close(); / 关闭 数据 库 游标 
mCheckResult = String.format(" 发 送 号 码 : %sm 短信 内 容 : %s", sender content); 
/ 依次 解析 流量 校准 短信 里 面 的 各 项 流量 数值 ， 并 拼接 流量 校准 的 结果 字符 串 
String flow = String.format(" 流 量 校准 结果 如 下 : \n\t 总 流量 为 :，%s\n\t 已 使 用 ，%s" + 
"nt 剩余: %s", findFlow(content "总 流量 为 " "MB7， 
findFlow(content, "已 使 用 ", "MB"), findFlow(content "剩余 ", "MB")); 
f(tv_check_flow !=nulD { // 离开 该 页 面 时 就 不 再 显示 流量 信息 
/ 把 流量 校准 结果 显示 到 文本 视图 tv_check flow 上 面 
tv_check flow.setText(flow); 
} 
super.onChange(selfChange); 


} 


/ 解析 流量 校准 短信 里 面 的 流量 数值 

private static String findFlow(String sms, String begin, String end) { 
int begin_pos = sms.indexOf(begin); 
if (begin pos <0){ 
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return "未 获取 "; 

上 

String sub_sms = sms.Substring(begin_pos); 

intend pos = sub sms.indexOfend); 

if (end pos<0){ 
return "未 获取 "; 

} 

return sub_sms.substring(begin.length(), end_pos + end.length()); 


流量 校准 的 效果 如 图 4-23 和 图 4-24 所 示 。 其 中 ， 图 4-23 所 示 为 用 户 实际 收 到 的 短信 内 
图 4-24 所 示 为 App 监视 短信 并 解析 完成 的 流量 数据 页 面 。 





您 好 ! 截止 2018 年 05 月 02 日 10 时 07 
分 ， 您 办 理 的 套餐 内 含 移动 数据 总 流 
量 为 2GB， 已 使 用 100MB,， 剩余 
1GB924MB ( 其 中 您 已 使 用 0MB， 
副 号 1 ( 159 呈 是 蚌 因 | ) 已 人 使 用 
OMB, 副 号 2 ( 135WW 烛 EN ) 已 
使 用 0MB ) 。 其 中 国内 流量 剩余 





1GB， 省 内 流量 剩余 924MB。 回 复 storage 
相应 序号 查 更 多 信息 : 111、 余额 项 

目 说 明 10、 缴 费 历史 查询 141、 套 a 

餐 资费 查询 0000、 增 值 业务 查 退 、 人 
121 了 解 话费 账单 项 目 说 明 。 流 量 不 流量 校准 结果 如 下 : 

够 用 ?不 限量 套餐 来 了 ,回复 74345 即 总 流量 为 : 2GB 

可 办 理 。 告 别 WIFI， 大 胆 用 放心 玩 ， 已 使 用 :100MB 

每 月 仅 需 40 元 。 【 中 国 移动 】 剩余 :1GB924MB 





图 4-23 用 户 收 到 的 短信 内 容 图 4.24 内容 观察 器 监视 并 解析 得 到 的 流量 信息 
总 结 一 下 在 Content 组 件 经 常 使 用 的 系统 URI， 详 细 的 URI 取 值 说 明 见 表 4-3。 
表 4-3 ”常用 的 系统 URI 取 值 说 明 


























内 容 名 称 URI 常量 名 实际 路 径 
联系 人 ContactsContract.Contacts.CONTENT_URI content://com.android.contacts/ 
contacts 

联系 人 电话 ContactsContract.CommonDataKinds. content://com.android.contacts/ 
Phone.CONTENT_URI data/phones 

联系 人 邮箱 ContactsContract.CommonDataKinds. content://com.android.contacts/ 
Email.CONTENT_URI data/emails 

SIM 卡 联系 人 content://icc/adn 

短信 Telephony.Sms.CONTENT_URI content://sms 

彩信 Telephony.Mms.CONTENT_URI content://mms 

通话 记录 CallLog.Calls.CONTENT_URI content://call log/calls 
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( 续 表 ) 

内 容 名 称 URI 常量 名 实际 路 径 
收 件 箱 Telephony.Sms.Inbox.CONTENT _URI( 短 信 相 关 的 URI) | content://sms/inbox 
已 发 送 Telephony.Sms.Sent.CONTENT_URI (短信 相关 的 URI) | content://sms/sent 
草稿 箱 Telephony.Sms.Draft.CONTENT_URI( 短 信 相 关 的 URI) | content://sms/draft 
发 件 箱 Telephony.Sms.Outbox.CONTENT_URI (短信 相关 的 content://sms/outbox 

URD 
发 送 失败 无 content://sms/failed 
待 发 送 列表 无 。 比 如 开启 飞行 模式 后 ， 该 短信 就 在 待 发 送 列表 里 | content://sms/queued 








4.6 ”实战 项 目 : 购物 车 


购物 车 的 应 用 面 很 广 ， 凡 是 电 商 App 都 可 以 看 到 购物 车 的 身影 。 本 章 以 购物 车 为 实战 项 
目 , 除了 购物 车 使 用 广泛 的 特点 , 还 因为 购物 车 用 到 多 种 存储 方式 。 现在 我 们 开启 购物 车 的 体 
验 之 旅 吧 ! 


4.6.1 设计 思 


先 来 看 常见 的 购物 车 的 外 观 。 第 一 次 进入 购物 车 频道 ， 购 物 车 里 面 是 空 的 ， 如 图 4-25 所 
示 。 接 着 去 商品 频道 选 购 手机 ， 随 便 挑 几 款 加 入 购物 车 ， 然 后 返回 购物 车 ， 即 可 看 到 购物 车 里 
的 商品 列表 ， 有 商品 图 片 、 名 称 、 数 量 、 单 价 、 总 价 等 信息 ， 如 图 4-26 所 示 。 

















购物 车 
国 盖 Mate10 
哎呀 ,购物 车 空空 如 也 ， 快 去 选 购 商 品 吧 
”be iPhone8 
和 手 手 手机 商场 园 小 米 6 
网 vivo X9S 
Se Em 
总 金额 20583 结算 
图 4-25 ”空空 如 也 的 购物 车 图 426 购物 车 的 商品 列表 


购物 车 的 存在 感 很 强 ， 并 不 仅仅 在 购物 车 页 面 才能 看 到 。 往 往 在 商场 频道 ， 甚 至 某 个 商 
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品 详情 页 面 ， 都 会 看 到 某 个 角落 冒 出 一 个 购物 车 图 标 。 一 旦 有 新 商品 加 入 购物 车 ， 购 物 车 图 标 
上 的 商品 数量 就 立马 加 一 。 当 然 , 用 户 也 可 以 点 击 购物 车 图 标 直接 跳 转 到 购物 车 页 面 。 商 品 频 
道 除 了 商品 列表 外 ,页 面 右上 角 还 有 一 个 购物 车 图 标 ， 这 个 图 标 有 时 在 页 面 右上 角 ， 有 时 又 在 
页 面 右 下 角 ， 如 图 4-27 所 示 。 商 品 详情 页 面 通常 也 有 购物 车 图 标 ， 如 果 用 户 在 详情 页 面 把 商 
品 加 入 购物 车 ， 那 么 图 标 上 的 数字 也 会 加 一 ， 如 图 4-28 所 示 。 

现在 看 看 购物 车 到 底 采 取 了 哪些 存储 方式 。 


e 数据 库 SQLite: 最 直观 的 是 数据 库 ， 购 物 车 里 的 商品 列表 一 定 放 在 SQLite 中 ， 增 删 
改 查 都 少不了 SQLite。 





6888 ”加 入 购物 车 3999 加 入 购物 车 
小 米 6 OPPO R11 


a 


2999 ”加 入 购物 车 。“ 2899 “加 入 购物 车 





2999.0 
小 米 MI6 全 网 通 版 66B+128GB 亮 白色 
加 入 购物 车 








图 4-27 手机 商场 的 商品 列表 图 4-28 商品 详情 页 面 


e@ 共享 参数 SharedPreferences: 注意 不 同 页 面 的 右上 角 购 物 车 图 标 都 有 数字 ， 表 示 购 物 
车 中 的 商品 数量 , 商品 数量 建议 保存 在 共享 参数 中 。 因 为 每 个 页 面 都 要 显示 商品 数量 ， 
如 果 每 次 都 到 数据 库 中 执行 count 操作 ， 就 会 很 消耗 资源 。 因 为 商品 数量 需要 持久 地 
存储 , 所 以 不 适合 放 在 全 局 内 存 中 , 不 然 下 次 启动 App 时 ， 内 存 中 的 变量 又 从 0 开始 。 

e SD 卡 文件 : 通常 情况 下 ， 商 品 图 片 来 自 于 电 商 平台 的 服务 器 ， 这 年 头 流量 是 很 宝贵 
的 ， 可 是 图 片 恰恰 很 耗 流量 (尤其 是 大 图 ) 。 从 用 户 的 钱包 着 想 ，App 得 把 下 载 的 图 
片 保存 在 SD 卡 中 。 这 样 一 来 ， 下 次 用 户 访问 商品 详情 页 面 时 ，App 便 能 直接 从 SD 
卡 获取 商品 图 片 ， 不 但 不 花 流量 而 且 加 快 浏览 速度 ， 一 举 两 得 。 

e@ 全 局 内 存 : 访问 SD 卡 的 图 片 文件 固然 是 个 好 主意 ， 然 而 商品 频道 、 购 物 车 频道 等 可 
能 在 一 个 页 面 展示 多 张 商品 小 图 ， 如 果 每 张 小 图 都 要 访问 SD 卡 ， 频 繁 的 SD 卡 读 写 
操作 也 很 耗资 源 。 更 好 的 办 法 是 把 商品 小 图 加 载 进 全 局 内 存 ， 这 样 直接 从 内 存 中 获取 
图 片 ， 高 效 又 快速 。 之 所 以 不 把 商品 大 图 放 入 全 局 内 存 ， 是 因为 大 图 很 耗 空间 ， 一 不 
小 心 就 会 占用 几 十 兆 内 存 。 


不 找 不 知道 ， 一 找 吓 一 跳 ， 原 来 购物 车 用 到 了 这 么 多 种 存储 方式 。 
4.6.2 小 知识 : 菜单 Menu 
之 前 的 章节 在 进行 某 项 控制 操作 时 一 般 由 按钮 控件 触发 。 如 果 页 面 上 需要 支持 多 个 控制 
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操作 ， 比 如 去 商场 购物 、 清 空 购物 车 、 查 看 商品 详情 、 删 除 指定 商品 等 ， 就 得 在 页 面 上 添加 多 
个 按钮 。 如 此 一 来 ，App 页 面 显 得 杂乱 无 章 ， 满 屏 按钮 既 碍 眼 又 不 便 操 作 。 这 时 ， 就 可 以 使 用 
菜单 控件 。 

菜单 无 论 在 哪里 都 是 常用 控件 , Android 的 菜单 主要 分 两 种 ,一 种 是 选项 菜单 OptionMenu， 
通过 按 菜单 键 或 点 击 事件 触发 ， 对 应 Windows 上 的 开始 菜单 ; 另 一 种 是 上 下 文 菜单 
ContextMenu， 通 过 长 按 事 件 触发 ， 对 应 Windows 上 的 右键 菜单 。 无 论 是 哪 种 菜单 ， 都 有 对 应 
的 菜单 布局 文件 ， 就 像 每 个 活动 页 面 都 有 一 个 布局 文件 一 样 。 不 同 的 是 页 面 的 布局 文件 放 在 
res/layout 目录 下 ， 菜 单 的 布局 文件 放 在 res/menu 目录 下 。 

下 面 来 看 Android 的 选项 菜单 和 上 下 文 菜单 。 


1. 选项 菜单 OptionMenu 
弹出 选项 菜单 的 途径 有 3 种 : 


(1) 按 菜 单 键 。 
(2) 在 代码 中 手动 打开 选项 菜单 ， 即 调用 openOptionsMenu 方法 。 
(3) 按 工 具 栏 右 侧 的 溢出 菜单 按钮 ， 这 个 在 第 7 章 介绍 工具 栏 时 进行 介绍 。 


实现 选项 菜单 的 功能 需要 重 写 以 下 两 种 方法 。 


e onCreateOptionsMenu: 在 页 面 打 开 时 调用 。 需 要 指定 菜单 列表 的 XML 文件 。 
e onOptionsItemSelected: 在 列表 的 菜单 项 被 选中 时 调用 。 需 要 对 不 同 的 菜单 项 做 分 支 处 
理 。 


下 面 是 菜单 布局 文件 的 代码 ， 很 简单 ， 就 是 menu 与 item 的 组 合 排列 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android" > 
<item 
android:id="@+id/menu_change_time" 
android:orderInCategory="1" 
android:title=" 改 变 时 间 "/> 
<item 
android:id="(@+tid/menu_change_color" 
android:orderInCategory="8" 
android:title=" 改 变 颜色 " 广 
<item 
android:id="@+id/menu_change bg" 
android:orderInCategory="9" 
android:title=" 改 变 背 景 "> 
</menu> 


接 下 来 是 使 用 选项 菜单 的 代码 片段 : 


// 在 选项 菜单 的 菜单 界面 创建 时 调用 
public boolean onCreateOptionsMenu(Menu menu) { 
/ 从 menu_option.xml 中 构建 菜单 界面 布局 
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getMenulnflater().inflate(R.menu.menu_option, menu); 
Teturn true; 
} 


/ 在 选项 菜单 的 菜单 项 选中 时 调用 
public boolean onOptionsItemSelected(Menultem item) { 
intid = item.getltemId(); / 获取 菜单 项 的 编号 
让 (id 一 Rid.menu_change time) { // 点 击 了 菜单 项 “改变 时 间 ” 
setRandomTime(); 
}elseif(id==R.id.menu change color){ // 点 击 了 菜单 项 “改变 颜色 ” 
tv_option.setTextColor(getRandomColor0); 
} elseif (id== Rid.menu_change bg) { // 点 击 了 菜单 项 “改变 背景 ” 
tv_option.setBackgroundColor(getRandomColor0); 
} 
return true; 
} 


按 菜 单 键 和 调用 openOptionsMenu 方法 弹出 的 选项 菜单 都 是 在 页 面 下 方 , 如 图 4-29 所 示 。 
改变 时 间 


改变 颜色 
改变 背景 





图 4-29 选项 菜单 的 菜单 列表 
2. 上 下 文 菜单 ContextMenu 
弹出 上 下 文 菜 单 的 途径 有 两 种 : 

(1) 默认 在 某 个 控件 被 长 按时 弹出 。 通 常 在 onStart 函数 中 加 入 registerForContextMenu 
方法 为 指定 控件 注册 上 下 文 菜单 , 在 onStop 函数 中 加 入 unregisterForContextMenu 方法 为 指定 
控件 注销 上 下 文 菜单 。 

(2) 在 除 长 按 事件 之 外 的 其 他 事件 中 打开 上 下 文 菜单 。 先 执行 registerForContextMenu 
方法 注册 菜单 ,然后 执行 openContextMenu 方法 打开 菜单 , 最 后 执行 unregisterForContextMenu 
方法 注销 菜单 。 

实现 上 下 文 菜单 的 功能 需要 重 写 以 下 两 种 方法 。 
e onCreateContextMenu: 在 此 指定 菜单 列表 的 XML 文件 ， 作 为 上 下 文 菜单 列表 项 的 来 
e@ ”onContextItemSelected: 在 此 对 不 同 的 菜单 项 做 分 支 处 理 。 


上 下 文 菜单 的 布局 文件 格式 同 选项 菜单 ， 下 面 是 使 用 上 下 文 菜单 的 代码 片段 : 
// 在 页 面 恢复 时 调用 





第 4 章 数据 存储 135 





protected void onResume() { 
/ 给 文本 视图 tv_context 注册 上 下 文 菜单 。 
/ 注册 之 后 ， 只 要 长 按 该 控件 ，App 就 会 自动 打开 上 下 文 菜单 
registerForContextMenu(ty_context); 
super.onResume(); 
i 


/ 在 页 面 暂停 时 调用 

protected void onPause() { 
1/ 给 文本 视图 tv_context 注销 上 下 文 菜单 
unregisterForContextMenu(tv_context); 
super.onPause(); 

上 


/ 在 上 下 文 菜单 的 菜单 界面 创建 时 调用 

public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menulnfo) { 
// 从 menu_option.xml 中 构建 菜单 界面 布局 
getMenulnflater().inflate(R.menu.menu_option, menu); 


/ 在 上 下 文 菜单 的 菜单 项 选中 时 调用 
public boolean onContextItemSelected(Menultem item) { 
intid = item.getItemId(); / 获取 菜单 项 的 编号 
if(id 一 R.id.menu_change time) { // 点 击 了 菜单 项 “改变 时 间 ” 
setRandomTime(); 
} else if (id == R.id.menu_change_color) { // 点 击 了 菜单 项 “改变 颜色 ” 
tv_context.setTextColor(getRandomColor()); 
} elseif (id == R.id.menu_change_bg) { // 点 击 了 菜单 项 “改变 背景 ” 
tv_context.setBackgroundColor(getRandomColor0); 
E 
return true; 


上 下 文 菜单 的 菜单 列表 固定 显示 在 页 面 中 部 ， 菜 单 外 的 其 他 页 面 区域 颜 色 会 变 深 ， 具体 
效果 如 图 4-30 所 示 。 





改变 时 间 
改变 颜色 


改变 背景 





图 4-30 上 下 文 菜单 的 菜单 列表 
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4.6.3 ”代码 示例 


这 一 章 的 编码 开始 有 些 复杂 了 ， 不 但 有 各 种 控件 和 布局 的 操作 ， 还 有 4 种 存储 方式 的 使 
用 ， 再 加 上 Activity 与 Application 两 大 组 件 的 运用 ， 已 然 是 一 个 正规 App 的 雏形 。 
编码 过 程 分 为 4 步 (增加 的 一 步 是 对 AndroidManifestxml 认真 配置 ) : 


CTO 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 购物 车 页 面 的 代码 文件 取 名 
ShoppingCartActivity.java， 对 应 的 布局 文件 名 是 activity_shopping_cart.xml; 商场 频道 页 面 的 代码 文 
件 取 名 ShoppingChannelActivityjava， 对 应 的 布局 文件 名 是 activity_shopping_channel.xml; 商品 详 
情 页 面 的 代码 文件 取 名 ShoppingDetailActivity， 对 应 的 布局 文件 名 是 activity_shopping_detail.xml; 
另 有 一 个 全 局 应 用 的 代码 文件 MainApplication.java。 









































(1) 注册 3 个 页 面 的 acitivity 节点 ， 注 册 代 码 如 下 : 
<activity android:name=".ShoppingCartActivity" android:theme="(@style/AppBaseTheme" /> 
<activity android:name=".ShoppingChannelActivity" /> 
<activity android:name=".ShoppingDetailActivity" /> 
(2) 给 application 补充 name 属性 ， 值 为 MainApplication， 举 例如 下 : 
android:name=".MainApplication" 
(3) 声明 SD 卡 的 操作 权限 ， 主 要 补充 下 面 3 行 权限 配置 : 
<!-- SD 卡 读 写 权 限 --> 
<uses-permission android:name="android.permission. WRITE EXTERNAL STORAGE" /> 
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAG" 亡 
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" /> 
CULT03 res 目录 下 的 XML 文件 编写 也 多 了 起 来 ， 主 要 工作 包括 : 


(1) 在 res/layout 目录 下 创建 布局 文件 activity shoppingcartxml 、 
activity_shopping_channel.xml、activity_shopping_detail.xml， 分 别 根据 页 面 效 果 图 编写 3 个 页 面 的 
布局 定义 文件 。 

(2) 在 res/menu 目录 下 创建 菜单 布局 文件 menu_cart.xml 和 menu_goods.xml， 分 别 用 于 购物 
车 的 选项 菜单 和 商品 项 的 上 下 文 菜单 。 

(3) 在 values/styles.xml 中 补充 下 面 的 样式 定义 ， 给 不 带 导航 栏 的 购物 车 页 面 使 用 : 
































<style name="AppBaseTheme" parent="Theme.AppCompat.Light" /> 


人 EX4 在 项 目的 包 名 目录 下 创建 类 MainApplication 、 ShoppingCartActivity 、 
ShoppingChannelActivity 和 ShoppingDetailActivity， 并 填 入 具体 的 控件 操作 与 业务 逻辑 代码 。 

购物 车 项 目的 完整 代码 参见 本 书 附录 源码 storage 模块 的 ShoppingCartActivity.java、 
ShoppingChannelActivity.java 和 ShoppingDetailActivityjava。 下 面 列 出 两 块 与 存储 技术 有 关 的 
代码 片段 ， 首 先是 商场 页 面 把 商品 加 入 购物 车 的 逻辑 处 理 ， 主 要 涉及 到 共享 参数 和 SQLite 数 
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据 库 的 运用 ， 关 键 代码 如 下 所 示 : 


private int mCount; / 购物 车 中 的 商品 数量 
private GoodsDBHelper mGoodsHelper; // 声明 一 个 商品 数据 库 的 帮助 器 对 象 
private CartDBHelper mCartHelper; / 声明 一 个 购物 车 数据 库 的 帮助 器 对 象 


/ 把 指定 编号 的 商品 添加 到 购物 车 
private void addToCart(long goods id) { 


ImCount++; 
tv_countsetText("" + mCount); 
// 把 购物 车 中 的 商品 数量 写 入 共享 参数 
SharedUtil.getIntance(this).writeShared("count", "" + mCount); 
/ 根据 商品 编号 查询 购物 车 数据 库 中 的 商品 记录 
CartInfo info = mCartHelper.queryByGoodsId(goods id); 
让 (info !=null) { // 购物 车 已 存在 该 商品 记录 
info.countt+; / 该 商品 的 数量 加 一 
info.update_time = DateUtil.getNowDateTime(""); 
/ 更 新 购物 车 数据 库 中 的 商品 记录 信息 
mCartHelper.update(info); 
} else { / 购物 车 不 存在 该 商品 记录 
info = new CartInfo(); 
info.goods_id = goods _id; 
info.count = 1; 
info.update_time = DateUtil.getNowDateTime(""); 
// 往 购 物 车 数据 库 中 添加 一 条 新 的 商品 记录 
mCartHelper.insert(info); 


/ 在 页 面 恢复 时 调用 
protected void onResume() { 


super.onResume(); 

/ 获取 共享 参数 保存 的 购物 车 中 的 商品 数量 
mCount = Integer.parseInt(SharedUtil.getIntance(this).readShared("count", "0")); 
tv_count.setText("" + mCount); 

/ 获取 商品 数据 库 的 帮助 器 对 象 

mGoodsHelper = GoodsDBHelper.getInstance(this, 1); 
/ 打开 商品 数据 库 的 读 连 接 
mGoodsHelper.openReadLink(); 

/ 获取 购物 车 数据 库 的 帮助 器 对 象 

mCartHelper = CartDBHelper.getInstance(this, 1); 

// 打开 购物 车 数据 库 的 写 连 接 

mCartHelper.open WriteLink(); 


/ 展示 商品 列表 
showGoods(); 
b 


/ 在 页 面 暂 停 时 调用 

protected void onPause() { 
super.onPause(); 
/ 关闭 商品 数据 库 的 数据 库 连 接 
mGoodsHelper.closeLink(); 
/ 关闭 购物 车 数据 库 的 数据 库 连 接 
mCartHelper.closeLink(); 

| 


然后 是 购物 车 页 面 模拟 从 网 络 上 下 载 商品 图 片 ， 并 构建 简单 的 图 片 缓存 机 制 的 逻辑 处 理 ， 
主要 涉及 到 SD 卡 文件 操作 与 Application 全 局 变量 的 运用 ， 关 键 代码 如 下 所 示 : 


private String mFirst = "true"; / 是 否 首次 打开 


/ 模拟 网 络 数据 ， 初 始 化 数据 库 中 的 商品 信息 
Private void downloadGoodsO { 
/ 获取 共享 参数 保存 的 是 否 首次 打开 参数 
mFirst = SharedUtil.getIntance(this).readShared("first", "true"); 
/ 获取 当前 App 的 私有 存储 路 径 
String path = MainApplication.getInstance().getExternalFilesDir( 
Environment.DIRECTORY_DOWNLOADS).toString() + "/"; 
让 (mFirst.equals("true")) { // 如 果 是 首次 打开 
ArrayList<GoodsInfo> goodsList = GoodsInfo.getDefaultList(); 
for (inti= 0; i < goodsList.size(); i++) { 
GoodsInfo info = goodsList.get(i); 
/ 往 商品 数据 库 插入 一 条 该 商品 的 记录 
long rowid = mGoodsHelper.insert(info); 
info.rowid = rowid; 
// 往 全 局 内 存 写 入 商品 小 图 
Bitmap thumb = BitmapFactory.decodeResource(getResources(), info.thumb); 
MainApplication.getInstance().mIcon Map.put(rowid, thumb); 
String thumb_path = path + rowid +"_s.jpg"; 
FileUtil.saveImage(thumb_path, thumb); 
info.thumb_path = thumb_path; 
/ 往 SD 卡 保存 商品 大 图 
Bitmap pic = BitmapFactory.decodeResource(getResources(), info.pic); 
String pic_path = path + rowid + ".jpg"; 
FileUtil.saveImage(pic_path, pic); 
pic.recycle(); 
info.pic_path = pic_path; 





/ 更 新 商品 数据 库 中 该 商品 记录 的 图 片 路 径 
mGoodsHelperupdate(info); 
} 
}else { // 不 是 首次 打开 
// 查询 商品 数据 库 中 所 有 商品 记录 
ArrayList<GoodsInfo> goodsArray =mGoodsHelper.query("1=1"); 
for (inti= 0; i < goodsArray.size(); iH+) { 
GoodsInfo info = goodsArray.get(i); 
// 从 指定 路 径 读 取 图 片 文件 的 位 图 数据 
Bitmap thumb = BitmapFactory.decodeFile(info.thumb_path); 
/ 把 该 位 图 对 象 保存 到 应 用 实例 的 全 局 变量 中 
MainApplication.getInstance().mIcon Map.put(info.rowid, thumb); 
» 
1 
/ 把 是 否 首次 打开 写 入 共享 参数 
SharedUtil.getIntance(this).writeShared("first", "false"); 


4.7 小 结 


本 章 主要 介绍 了 Android 常用 的 几 种 数据 存储 方式 , 包括 共享 参数 SharedPreferences 的 键 
值 对 存 取 、 数 据 库 SQLite 的 关系 型 数据 存 取 、SD 卡 的 文件 写 入 与 读 取 操作 ( 含 文本 文件 读 写 
和 图 片 文件 读 写 ) 、App 全 局 内 存 的 读 写 以 及 为 实现 全 局 内 存 而 学 习 的 Application 组 件 的 生 
命 周 期 及 其 用 法 、ContentProvider 内 容 组 件 的 用 法 内容 提 供 器 、 内 容 解析 器 、 内 容 操作 器 、 
内 容 观察 器 ) 。 最 后 设计 了 一 个 实战 项 目 “ 购 物 车 ”, 通过 该 项 目的 编码 进一步 复习 巩固 本 章 
几 种 存储 方式 的 使 用 ， 另 外 介绍 了 选项 菜单 和 上 下 文 菜单 的 基本 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 

(1) 学 会 共享 参数 SharedPreferences、 数 据 库 SQLite、SD 卡 文件 、 全 局 内 存 、 内 容 提供 
器 共 5 种 存储 方式 的 用 法 。 

(2) 学 会 应 用 组 件 Application 的 用 法 。 

(3) 学 会 内 容 组 件 ContentProvider 的 用 法 ， 如 封装 数据 的 对 外 接口 ， 对 开放 内 容 接口 的 
系统 数据 进行 查询 、 修 改 和 监视 操作 。 

(4) 学 会 选项 菜单 和 上 下 文 菜单 的 基本 用 法 。 


本 章 介绍 App 开发 常用 的 一 些 高 级 控件 及 相关 工具 ， 主 要 包括 日 期 时 间 控 件 的 用 法 、 列 
表 类 视图 及 其 适配器 的 用 法 、 翻 页 类 视图 及 其 适配器 的 用 法 、 碎 片 及 其 适配器 的 用 法 等 ,另外 
介绍 四 大 组 件 之 一 广播 Broadcast 的 基本 概念 与 常见 用 法 。 最 后 结合 本 章 所 学 的 知识 分 别 演示 
了 两 个 实战 项 目 “ 万 年 历 ” 和 “日 程 表 ”的 设计 与 实现 。 


5.1 日 期 时 间 控 件 


本 节 介 绍 Android 的 日 期 时 间 控 件 ， 主 要 是 日 期 选择 对 话 框 DatePickerDialog 和 时 间 选 择 
对 话 框 TimePickerDialog 的 用 法 。 


5.1.1 日 期 选择 器 DatePicker 


虽然 EditText 控件 提供 inputType="date" 的 日 期 输入 ， 但 是 很 少 有 用 户 会 老 老实 实地 手工 
输入 日 期 , 况且 EditText 还 不 支持 “*#### 年 ** 月 ** 日 ”这 样 的 日 期 格式 ， 所 以 都 要 系统 提供 日 
期 控件 ， 供 用 户 选 择 具体 的 年 月 日 ， 在 Android 中 这 个 控件 是 DatePicker。 不 过 ，DatePicker 
并 非 弹 窗 模式 , 而 是 直接 在 页 面 上 占据 一 块 区 域 ， 并且 不 会 自动 关闭 。 按 习惯 来 说 ,日 期 控件 
应 该 在 当前 页 面 弹 出 , 选择 完 日 期 就 要 把 控件 关 掉 。 因此, DatePicker 很 少 直接 显示 在 界面 上 ， 
更 常用 的 是 已 经 封装 好 的 日 期 选择 对 话 框 DatePickerDialog。 

DatePickerDialog 相当 于 在 AlertDialog 上 加 载 了 DatePicker， 用 起 来 更 简单 ， 只 需 调用 构 
造 函 数 设置 一 下 当前 年 、 月 、 日 ， 然 后 调用 show 方法 即 可 弹出 日 期 对 话 框 。 日 期 选择 事件 由 
监听 器 OnDateSetListener 负责 响应 , 在 该 监听 器 实现 的 onDateSet 方法 中 , 开发 者 能 够 获得 用 
户 选择 的 具体 日 期 ， 并 做 后 续 处 理 。 这 里 要 特别 注意 onDateSet 方法 的 月 份 参数 ， 该 参数 的 起 
始 值 不 是 1 而 是 0。 也 就 是 说 ， 一 月 份 对 应 的 参数 数值 是 0， 十 二 月 份 对 应 的 参数 数值 是 11。 





第 5 章 高 级 控件 | 141 








如 果实 在 不 理解 ， 记 住 这 里 的 月 份 值 要 加 1 就 行 了 。 
在 界面 上 单独 显示 DatePicker 的 效果 如 图 5-1 所 示 , 其 中 , 年 、 月、 日 通过 上 下 滑动 选择 。 
在 界面 上 弹出 日 期 对 话 框 的 效果 如 图 5-2 所 示 ， 其 中 年 、 月 、 日 按照 日 历 风格 展示 与 选择 。 


2018 


3 月 20 日 周二 


请 选择 日 期 


2018 年 3 月 











2018 生 3 208 





2019 4 





确定 
您 选择 的 日 期 是 2018 年 3 月 20 日 
图 5-1 日 期 选择 器 的 截图 图 5-2 日 期 对 话 框 的 截图 





下 面 是 使 用 日 期 选择 器 和 日 期 对 话 框 的 代码 例子 : 


// 该 页 面 类 实现 了 接口 OnDateSetListener， 意 味 着 要 重 写 日 期 监听 器 的 onDateSet 方法 
public class DatePickerActivity extends AppCompatActivity implements 
OnClickListener, OnDateSetListener { 
private TextView tv_date; 
private DatePicker dp_date; / 声明 一 个 日 期 选择 器 对 象 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_date_picker); 
tv_date = findViewById(R.id.tv_date); 
// 从 布局 文件 中 获取 名 叫 dp_date 的 日 期 选择 器 
dp_date = findViewById(R.id.dp_date); 
findViewByld(R.id.btn_date).setOnClickListener(this); 
findViewByld(R.id.btn_ok).setOnClickListener(this); 

} 


@Override 
public void onClick(View v) { 
if (v.getId() 一 R.id.btn_date) { 
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/ 获取 日 历 的 一 个 实例 ， 里 面包 含 了 当前 的 年 月 日 

Calendar calendar = Calendar.getInstance(); 

// 构建 一 个 日 期 对 话 框 ， 该 对 话 框 已 经 集成 了 日 期 选择 器 。 

// DatePickerDialog 的 第 二 个 构造 参数 指定 了 日 期 监听 器 

DatePickerDialog dialog = new DatePickerDialog(this, this, 
calendar.get(Calendar.YEAR)，// 年 份 
calendar.get(Calendar.MONTH)，// 月 份 
calendarget(CalendarDAY_ OF MONTH)); // 日 子 

/ 把 日 期 对 话 框 显示 在 界面 上 

dialog.show(); 

} else if (v.getId() 一 R.id.btn_ok) { 

// 获取 日 期 选择 器 dp_date 设 定 的 年 月 份 

String desc = String.format(" 您 选择 的 日 期 是 %d 年 %d 月 %d 日 "， 
dp_date.getYear(), dp_date.get Month() + 1, dp_date.getDayOfMonth()); 

tv_date.setText(desc); 


// 一 旦 点 击 日 期 对 话 框 上 的 确定 按钮 ， 就 会 触发 监听 器 的 onDateSet 方法 
public void onDateSet(DatePicker view, int year, int monthOf Year, int dayOfMonth) { 
/ 获取 日 期 对 话 框 设 定 的 年 月 份 
String desc = String.format(" 您 选择 的 日 期 是 %d 年 %d 月 %d 日 ", 
year, monthOf Year + 1, dayOf Month); 
tv_date.setText(desc); 


} 
5.1.2 时间 选择 器 TimePicker 


有 了 日 期 选择 器 , 肯定 有 对 应 的 时 间 选 择 器 。 同样 , 实际 开发 中 也 很 少 直接 用 TimePicker， 
而 是 常用 封装 好 的 时 间 选 择 对 话 框 TimePickerDialog。 该 对 话 框 的 用 法 类 似 DatePickerDialog， 
不 同 之 处 主要 有 两 个 : 
(1) 构造 函数 传 的 是 当前 的 小 时 与 分 钟 ， 最 后 一 个 参数 表示 是 否 采 用 二 十 四 小 时 制 ， 
般 传 tue， 表 示 小 时 的 数值 范围 为 0 一 23 。 
(2) 时 间 选 择 监听 器 是 OnTimeSetListener， 对 应 需要 实现 的 方法 是 onTimeSet， 在 该 方 
法 中 可 获得 用 户 选 好 的 小 时 和 分 钟 。 
在 界面 上 单独 显示 TimePicker 的 效果 如 图 5-3 所 示 , 其 中 , 小 时 与 分 钟 可 通过 上 下 滑动 选 
择 。 在 界面 上 弹出 时 间 对 话 框 的 效果 如 图 5-4 所 示 , 其 中 小 时 与 分 钟 按照 钟表 风格 展示 与 选择 。 


第 5 章 高 级 控件 | 143 








您 选择 的 时 间 是 15 时 38 分 


图 5-3 ”时间 选择 器 的 截图 图 5-4 ”时间 对 话 框 的 截图 
下 面 是 使 用 时 间 选择 器 和 时 间 对话 框 的 代码 例子 : 
// 该 页 面 类 实现 了 接口 OnTimeSetListener， 意 味 着 要 重 写 时 间 监 听 器 的 onTimeSet 方法 
public class TimePickerActivity extends AppCompatActivity implements 
OnClickListener, OnTimeSetListener { 


private TextView tv_time; 
private TimePicker tp_time;”// 声明 一 个 时 间 选 择 器 对 象 





@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_time_picker); 
tv_time = findViewById(R.id.tv_time); 
/ 从 布局 文件 中 获取 名 叫 tp_time 的 时 间 选 择 器 
tp_time = findViewById(R.id.tp_time); 
findViewById(R.id.btn_time).setOnClickListener(this); 
findViewById(R.id.btn_ok).setOnClickListener(this); 

) 


@Override 
public void onClick(View v) { 
if (v.getId() 一 R.id.btn time) { 
// 获取 日 历 的 一 个 实例 ， 里 面包 含 了 当前 的 时 分 秘 
Calendar calendar = Calendar.getInstance(); 
// 构建 一 个 时 间 对 话 框 ， 该 对 话 框 已 经 集成 了 时 间 选 择 器 。 
// TimePickerDialog 的 第 二 个 构造 参数 指定 了 时 间 监 听 器 
TimePickerDialog dialog = new TimePickerDialog(this, this, 
calendar.get(Calendar.HOUR_OF_DAY)，// 小 时 
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calendar.get(Calendar.MINUTE)，// 分 钟 
true); /true 表示 24 小 时 制 ，false 表示 12 小 时 制 
// 把 时 间 对 话 框 显示 在 界面 上 
dialog.show(); 
} else if (v.getId() 一 R.id.btn_ok) { 
// 获取 时 间 选 择 器 tp_time 设 定 的 小 时 和 分 钟 
String desc = String.format(" 您 选择 的 时 间 是 %d 时 %d 分 "， 
tp_time.getCurrentHour(), tp_time.getCurrentMinute()); 
tv_time.setText(desc); 


} 


/ 一 旦 点 击 时 间 对 话 框 上 的 确定 按钮 ， 就 会 触发 监听 器 的 onTimeSet 方法 

public void onTimeSet(TimePicker view, int hourOfDay, int minute) { 
/ 获取 时 间 对 话 框 设 定 的 小 时 和 分 钟 
String desc = String.format(" 您 选择 的 时 间 是 %d 时 %d 分 ", hourOfDay, minute); 
tv_time.setText(desc); 


5.2 ”列表 类 视图 


本 节 介绍 列表 类 视图 怎样 结合 基本 适配器 实现 视图 展示 的 效果 ， 包 括 基本 适配器 
BaseAdapter 的 用 法 、 列 表 视 图 ListView 的 分 隔 线 设 置 与 使 用 注意 点 、 网 格 视图 GridView 的 
分 隔 线 设 置 与 使 用 注意 点 。 


5.2.1 基本 适配器 BaseAdapter 


第 3 章 介绍 下 拉 框 Spinner 时 提 到 该 控件 可 使 用 ArrayAdapter 和 SimpleAdapter 两 种 适 配 
器 。 其 中 ，ArrayAdapter 适用 于 纯 文 本 的 列表 数据 ，SimpleAdapter 适用 于 带 图 标的 列表 数据 。 
实际 应 用 中 常常 有 更 复杂 的 列表 , 比如 同一 项 中 存在 多 个 控件 , 这 种 情况 即使 用 SimpleAdapter 
也 很 吃力 , 而 且 不 易 扩 展 。 基 于 此 , Android 提供 了 一 种 适应 性 更 强 的 基本 适配器 BaseAdapter， 
该 适配器 允许 开发 者 在 别 的 代码 文件 中 进行 逻辑 处 理 ， 大 大 提高 了 代码 的 可 读 性 和 可 维护 性 。 

从 BaseAdapter 派生 的 数据 适配器 主要 实现 下 面 3 个 方法 。 

e@ 构造 函数 : 指定 适配器 需要 处 理 的 数据 集合 。 

e getCount: 获取 数据 项 的 个 数 。 

e@ getView: 获取 每 项 的 展示 视图 ， 并 对 每 项 的 内 部 控件 进行 业务 处 理 。 


下 面 以 Spinner 控件 为 载体 ， 演 示 如 何 操作 BaseAdapter， 具 体 的 编码 分 为 3 步 : 
人 6i 编写 列表 项 的 布局 文件 ， 示 例 代码 如 下 : 
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<LinearLayout xmlIns:android="http://schemas.android.com/apk/res/android" 


android:layout_ width="match_parent" 
android:layout_height="wrap_content" 
android:background="(@color/white" 
android:orientation="horizontal" > 


<!-- 这 是 显示 行星 图 片 的 图 像 视图 一 > 
<ImageView 
android:id="(@+id/iv_icon" 
android:layout_width="0dp" 
android:layout_height="80dp" 
android:layout_weight="1" 
android:scaleType="fitCenter" /> 


<LinearLayout 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="3" 
android:orientation="vertical" > 


<!-- 这 是 显示 行星 名 称 的 文本 视图 --> 
<TextView 
android:i 





="(@+tid/tvy_name" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="1" 
android:gravity="leftlcenter" 
android:textColor="(@color/black" 
android:textSize="20sp" /> 


<!- 这 是 显示 行星 描述 的 文本 视图 --> 
<TextView 
android:id="(@+id/tv_dese" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="2" 
android:gravity="leftlcenter" 
android:textColor="(@color/black" 
android:textSize="13sp" 亡 
</LinearLayout> 
</LinearLayout> 








C102 写 个 新 的 适配器 继承 BaseAdapter, 实现 对 列表 项 视 











的 获取 与 操作 , 示例 代码 如 下 : 
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public class PlanetListAdapter extends BaseAdapter { 
private Context mContext; // 声明 一 个 上 下 文 对 象 
private ArrayList<Planet> mPlanetList; / 声明 一 个 行星 信息 队列 


// 行星 适配器 的 构造 函数 ， 传 入 上 下 文 与 行星 队列 

public PlanetListAdapter(Context context, ArrayList<Planet> planet list) { 
mContext = context; 
mPlanetList = planet list; 

b 


/ 获取 列表 项 的 个 数 
public int getCount() { 
return mPlanetList.size(); 


b 


/ 获取 列表 项 的 数据 

public Object getItem(int arg0) { 
return mPlanetList.get(arg0); 

| 


/ 获取 列表 项 的 编号 
public long getItemId(int arg0) { 
return arg0; 


/ 获取 指定 位 置 的 列表 项 视图 
public View getView(final int position, View convertView, ViewGroup parent) { 
ViewHolder holder; 
让 (convertView 一 null) { // 转换 视图 为 空 
holder = new ViewHolder0; / 创建 一 个 新 的 视图 持 有 者 
// 根据 布局 文件 item_listxml 生成 转换 视图 对 象 
convertView = LayoutInflater.from(mContext).inflate(R.layout.item_list, null); 
holderiv_icon = convertView.findViewById(R.id.iv_icon); 
holder.tv_name = convertView.findViewById(R.id.tv_name); 
holdertv_desc = convertView.findViewById(R_.id.tv_desc); 
/ 将 视图 持 有 者 保存 到 转换 视图 当中 
convertView.setTag(holder); 
} else { // 转换 视图 非 空 
// 从 转换 视图 中 获取 之 前 保存 的 视图 持 有 者 
holder = (ViewHolder) convertView.getTag(); 
} 
Planet planet = mPlanetList.get(position); 
holder.iv_icon.setImageResource(planet.image); // 显示 行星 的 图 片 
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holdertv_name.setText(planetname); // 显示 行星 的 名 称 
holder.tv_desc.setText(planet.desc); / 显示 行星 的 描述 
Teturn convertView; 


} 


// 定义 一 个 视图 持 有 者 ， 以 便 重用 列表 项 的 视图 资源 

public final class ViewHolder { 
public ImageView iv_icon; / 声明 行星 图 片 的 图 像 视图 对 象 
public TextView tv_name; / 声明 行星 名 称 的 文本 视图 对 象 
public TextView tv_desc; / 声明 行星 描述 的 文本 视图 对 象 


} 
C703 在 页 面 代 码 中 构造 该 适配器 ， 并 应 用 于 Spinner 对 象 ， 示 例 代码 如 下 : 


private ArrayList<Planet> planetList;，// 声明 一 个 行星 队列 

















// 初始 化 行星 列表 的 下 拉 框 
private void initPlanetSpinner() { 
// 获取 默认 的 行星 队列 ， 即 水 星 、 金 星 、 地 球 、 火 星 、 木 星 、 土 星 
planetList = Planet.getDefaultList(); 
/ 构建 一 个 行星 列表 的 适配器 
PlanetListAdapter adapter = new PlanetListAdapter(this, planetList); 
/ 从 布局 文件 中 获取 名 叫 sp_planet 的 下 拉 框 
Spinner sp = findViewById(R.id.sp_planet); 
/ 设置 下 拉 框 的 标题 
sp.setPrompt(" 请 选择 行星 "); 
/ 设置 下 拉 框 的 列表 适配器 
sp.setAdapter(adapter); 
/ 设置 下 拉 框 默认 显示 第 一 项 
sp.setSelection(0); 


/ 给 下 拉 框 设置 选择 监听 器 ， 一 旦 用 户 选中 某 一 项 ， 就 触发 监听 器 的 onItemSelected 方法 


sp.setOnltemSelectedListener(new MySelectedListener()); 
由 


// 定义 一 个 选择 监听 器 ， 它 实现 了 接口 OnItemSelectedListener 
Private class MySelectedListener implements OnItemSelectedListener { 


/ 选择 事件 的 处 理 方法 ， 其 中 arg2 代表 选择 项 的 序号 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 


Toast.makeText(BaseAdapterActivity.this, "您 选择 的 是 " + planetList.get(arg2).name, 


ToastLENGTH_ LONG).show0; 
} 
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/ 未 选择 时 的 处 理 方法 ， 通 常 无 需 关 注 
public void onNothingSelected(AdapterView<?> arg0) {} 
) 
具体 的 列表 对 话 框 效果 如 图 5-5 所 示 。 可 以 看 到 ， 每 行 左边 是 行星 图 标 ， 右 边 的 上 面 是 行 
星 名 称 ， 下 面 是 行星 的 描述 。 因 为 对 列表 项 布局 item_listxml 使 用 了 单独 的 适配器 代码 
PlanetListAdapter， 所 以 再 多 加 几 个 控件 也 不 怕 麻 烦 了 。 


择 行星 
水 星 
水 星 是 太阳 系 八大 行星 最 内 侧 也 是 最 小 的 一 颗 行 
星 ， 也 是 离 太阳 最 近 的 行星 


金星 


金星 是 太阳 系 八大 行星 之 一 ， 排 行 第 二 ， 距 离 太 
阳 0.725 天 文 单位 


地 球 
地 是 大 阳 素 人 大 行星 元 措 人 条 三 


系 中 直径 、 估 二 和 要 训 避 大 的 区 地 下摆 到 
条 里 

火星 

火星 是 太阳 系 八大 行星 之 一 ， 排 行 第 四 ， 属 于 类 
地 行星 ， 直 径 约 为 地 球 的 53% 


木星 

木星 是 太阳 系 八大 行星 中 体积 最 大 、 自 转 最 快 的 
行星 ， 排行 第 五 。 它 的 质量 为 太阳 的 千 分 之 

一 , 但 为 太阳 系 中 其 它 七 大 行星 质量 总 和 


土星 


土星 为 太阳 系 八大 行星 之 一 ， 排 行 第 六 ， 体 积 仅 
次 于 木星 





图 5-5 下 拉 列 表 中 的 基本 适配器 效果 
5.2.2 ”列表 视图 ListView 


上 一 小 节 给 Spinner 控件 加 上 了 基本 适配器 ， 然 而 ， 著 e 
列表 效果 只 在 弹出 对 话 框 中 展示 ， 一 旦 选中 某 项 ， 回 到 
页 面 时 又 只 显示 选中 的 内 容 ， 如 图 5-6 所 示 。 

这 么 丰富 的 列表 信息 没 展示 在 页 面 上 实在 是 可 惜 ， 园 :: A 
也 许 用 户 对 好 几 项 内 容 都 感 兴趣 。 如 果 想 在 页 面 上 直接 
显示 全 部 列表 信息 ， 就 要 引入 新 的 列表 视图 ListView。 图 5-6 下 拉 框 在 页 面 上 只 显示 一 行 
ListView 允许 在 页 面 上 分 行 展示 相似 的 数据 界面 ， 如 新 闻 列表 、 商 品 列表 、 书 籍 列表 等 ,方便 
用 户 逐 行 浏览 与 操作 。 列 表 视 图 ListView 新 增 的 属性 与 方法 说 明 见 表 5-1。 


表 5-1 ListView 的 属性 与 方法 说 明 


行星 的 列表 视图 














XML 中 的 属性 ListView 类 的 设置 方法 “| 说 明 
divider setDivider 指定 分 隔 线 的 图 形 。 如 需 取消 分 隔 线 ， 可 设置 该 属性 
值 为 @null 








dividerHeight setDividerHeight 指定 分 隔 线 的 高 度 
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( 续 表 ) 





XML 中 的 属性 ListView 类 的 设置 方法 | 说 明 
headerDividersEnabled | setHeaderDividersEnabled | 指定 是 否 显示 列表 开头 的 分 隔 线 
setFooterDividersEnabled | 指定 是 否 显示 列表 末尾 的 分 隔 线 












footerDividersEnabled 


另外 ，ListView 实现 了 3 个 与 适配器 相关 的 方法 。 


e@ setAdapter: 设置 列表 项 的 数据 适配器 ， 适 配器 一 般 继 承 BaseAdapter。 
e@ setOnItemClickListener: 设置 列表 项 的 点 击 事件 监听 器 OnItemClickListener。 
e setOnItemLongClickListener: 设置 列表 项 的 长 按 事件 监听 器 OnItemLongClickListener。 


下 面 是 列表 项 处 理 点 击 事件 和 长 按 事 件 的 代码 : 


// 处 理 列表 项 的 点 击 事件 ， 由 接口 OnltemClickListener 触发 
public void onltemClick(AdapterView<?> parent View view, int position, long id) { 
String desc = String.format(" 您 点 击 了 第 %d 个 行星 ， 它 的 名 字 是 %s", position + 1, 
mpPlanetList.get(position).name); 
Toast.makeText(mContext, desc, Toast. LENGTH_LONG).show(); 
) 


/ 处 理 列表 项 的 长 按 事件 ， 由 接口 OnItemLongClickListener 触发 
public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) { 
String desc = String.format(" 您 长 按 了 第 %d 个 行星 ， 它 的 名 字 是 %s", position + 1， 
mpPlanetList.get(position).name); 
Toast.makeText(mContext, desc, Toast.LENGTH_LONG).show(); 
Teturn true; 


} 


光 看 这 些 文字 会 觉得 ListView 是 个 加 强 版 的 Spinner， 不 但 可 以 直接 在 页 面 上 展示 列表 ， 
而 且 能 设置 分 隔 线 与 点 击 监听 器 。 事 实 上 ，ListView 很 令 人 头痛 ， 使 用 过 程 中 经 常 出 现 意 想 不 
到 的 状况 ， 比 如 分 隔 线 就 容易 出 状况 ， 下 面 演示 分 隔 线 的 测试 代码 片段 : 
class DividerSelectedListener implements OnItemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
int dividerHeight = 5; 
LinearLayout.LayoutParams params = new LinearLayout.LayoutParams( 
LayoutParams.MATCH_PARENT, LayoutParams. WRAP_CONTENT); 
lv_planet.setDivider(drawable); / 设置 lv_planet 的 分 隔 线 
lv_planet.setDividerHeight(dividerHeighb; / 设置 lv_planet 的 分 隔 线 高 度 
lv_planet.setPadding(0, 0, 0, 0); / 设置 lv_planet 的 四 周 空白 
lv_planet.setBackgroundColor(ColorTRANSPARENT); / 设置 lv_planet 的 背景 颜色 
if(ar82 一 0){ // 不 显示 分 隔 线 (分 隔 线 高 度 为 0) 
lv_planet.setDividerHeight(0); 
}elseif(arg2 一 1){ // 不 显示 分 隔 线 (分 隔 线 为 nulD 
lv_planet.setDivider(nulD); 
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lv_planet.setDividerHeight(dividerHeight); 

}elseif(arg2 一 2){ // 只 显示 内 部 分 隔 线 ( 先 设 置 分 隔 线 高 度 ) 
lv_planet.setDividerHeight(dividerHeight); 
lv_planet.setDivider(drawable); 

} else if(arg2 一 3){ // 只 显示 内 部 分 隔 线 (后 设置 分 隔 线 高 度 ) 
lv_planet.setDivider(drawable); 
lv_planet.setDividerHeight(dividerHeight); 

} else if(arg2 一 4){ // 显示 底部 分 隔 线 (高 度 是 wrap_content) 
lv_planet.setFooterDividersEnabled(true); 

} else if(arg2 一 5){ // 显示 底部 分 隔 线 (高 度 是 match_parent) 
params = new LinearLayout.LayoutParams(LayoutParams.MATCH PARENT, 0, 1); 
lv_planet.setFooterDividersEnabled(true); 

} else if (arg2 一 6) { / 显示 顶部 分 隔 线 ( 别 睹 折腾 了 ， 显 示 不 了 ) 
params = new LinearLayout.LayoutParams(LayoutParams.MATCH PARENT., 0, 1); 
lv_planet.setFooterDividersEnabled(true); 
lv_planet.setHeaderDividersEnabled(true); 

} else if(arg2 一 7) { / 显示 全 部 分 隔 线 (看 我 用 padding 大 法 ) 
lv_planet.setDivider(null); 
lv_planet.setDividerHeight(dividerHeight); 
lv_planet.setPadding(0, dividerHeight 0, dividerHeight); 
lv_planetsetBackgroundDrawable(drawable); 

lv_planet.setLayoutParams(params); / 设置 lv_planet 的 布局 参数 

} 


public void onNothingSelected(AdapterView<?> arg0) {} 
| 


根据 分 隔 线 测 试 代码 的 演示 结果 ， 笔 者 总 结 了 一 下 ， 大 概 有 以 下 5 种 情况 : 


(1) 代码 中 的 setDivider 方法 只 能 设置 具体 的 图 片 ， 不 能 设置 颜色 ， 即 使 把 颜色 值 转 为 
ColorDrawable 也 不 行 。 在 布局 文件 中 可 对 divider 属性 直接 指定 颜色 值 。 

(2) divider 属性 设置 为 @null 时 不 能 再 设置 dividerHeight 属性 为 大 于 0 的 数值 ， 因 为 这 
样 一 来 最 后 一 项 就 不 会 完全 显示 ， 底 部 有 一 部 分 被 掩盖 了 。 原 因 是 列表 高 度 为 wrap_content 
时 ,系统 已 按照 没有 分 隔 线 的 情况 计算 列表 高 度 ,此 时 dividerHeight 占用 了 n-1 块 空白 分 隔 区 
域 ， 最 后 一 项 被 挤 到 背影 里 面 去 了 ， 具 体 效果 如 图 5-7 所 示 。 

(3) 代码 中 要 设置 分 隔 线 ， 务 必 先 调用 setDivider 方法 再 调用 setDividerHeight 方法 。 如 
果 先 调用 setDividerHeight 再 调用 setDivider， 分 隔 线 高 度 就 会 变 成 分 隔 图 片 的 高 度 ， 而 不 是 
setDividerHeight 设置 的 高 度 ， 具 体 效果 如 图 5-8 所 示 。 布 局 文件 不 存在 先后 顺序 问题 。 

(4) 显示 列表 底部 的 分 隔 线 是 有 条 件 的 ， 即 当前 ListView 的 高 度 不 能 为 wrap_content， 
否则 就 算 把 footerDividersEnabled 设置 为 true、 调 用 setFooterDividersEnabled 方法 设置 为 true， 
这 条 底部 的 分 隔 线 也 不 会 出 现 。 除非 把 列表 的 高 度 设置 为 match_parent 或 设置 足够 高 , 才 会 显 
示 底 部 的 分 隔 线 ， 调 整 列表 高 度 后 的 具体 效果 如 图 5-9 所 示 。 
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Senior 
不 显示 分 隔 线 (分 隔 线 为 null) 示 ”只 显示 内 部 分 隔 线 ( 先 设置 分 隔 线 高 度 ) ~ 
水 星 水 星 


水 旺 是 太阳 系 八 大 行星 最 内 侧 也 是 最 小 的 一 颗 行 
水 星 是 太阳 系 八大 行星 最 内 侧 也 是 最 小 的 一 颗 行 星 ,也 是 高 太阳 最 近 的 行星 
星 ， 也 是 离 太阳 昌 近 的 行星 


上 金星 是 太阳 系 八 大 行星 之 一 ， 排 行 第 二 ， 距 鹿 太 
金星 是 大 阳 系 八大 行星 之 一 ， 排行 第 二 ,距离 太 » 
阳 0.725 天 文 单位 


地 球 es 地 球 

和 ee 地 球 是 大 阳 系 八大 行星 之 一 ， 排行 阳 系 
地 球 是 太阳 系 八大 行星 之 一 ， 排行 第 三 ， 也 是 太阳 系 中 直径 、 质 量 和 密度 最 大 的 基地 行星 ， 二 向 1 
中 直径 质量 和 密度 最 大 的 类 地 行星 ,距离 太阳 1.5 亿 | 上 
公 
火星 全 

| | 火星 是 太阳 系 八大 行星 之 一 ， 排 行 第 四 ,属于 类 地 行 

火星 是 太阳 系 八大 行星 之 一 ， 排 行 第 四 ,属于 类 地 行 , 直径 约 53% 
星 ， 直 径 约 为 地 球 的 53% 于 


木星 
木星 是 太阳 系 八大 行星 中 体积 最 大 、 自 转 最 快 的 行 大人 


星 ， 排行 第 五 。 它 的 质量 为 太阳 的 千 分 之 一 ， 但 为 太 
阳 系 中 其 它 七 大 行星 质量 总 和 的 2.5 倍 
土星 


土星 为 太阳 系 八大 行星 之 一 ,排行 第 六 ， 体 积 仅 次 于 A + 排行 第 六 ， 体 积 仅 次 于 








5-7 divider 属性 设置 为 @null 图 5-8” 先 调用 setDividerHeight 


(5) 列表 项 部 的 分 隔 线 就 更 难 办 了 ，ListView 不 会 显示 项 部 的 分 隔 线 。 无 论 
headerDividersEnabled 属性 还 是 setHeaderDividersEnabled 方法 都 没有 作用 ， lt a 
也 没什么 用 ， 非 常 难 以 解决 。 


分 隔 线 显 示 显示 底部 分 隔 线 (高 度 是 match_parent) ~ 


水 星 


水 星 是 太阳 系 八大 行星 最 内 侧 也 是 最 小 的 一 颗 行 
星 ,也 是 离 太阳 最 近 的 行星 


金星 


金星 是 太阳 系 八大 行星 之 一 ， 排 行 第 二 ， 距 离 太 
阳 0.725 天 文 单位 


地 球 


地 球 是 太阳 系 八大 行星 之 一 ， 排 行 第 三 ， 也 是 太阳 系 


显示 全 部 分 隔 线 (看 我 用 padding 大 法 ) ~ 


水 星 


水 星 是 太阳 系 八大 行星 最 内 侧 也 是 最 小 的 一 颗 行 
星 ， 也 是 元 太阳 最 近 的 行星 


金星 


人 金星 是 太阳 系 八大 行星 之 一 ， 排 行 第 二 ， 
阳 0.725 天 文 单位 


地 球 


地 球 是 太阳 系 八大 行星 之 一 ， 排 行 


中 直径 、 质 量 和 密度 最 大 的 类 地 行星 ， 距 离 太 阳 1.5 亿 中 直径 、 质 量 和 密度 最 大 的 类 地 行星 


火星 
火星 是 太阳 系 八大 行星 之 一 ， 排 行 第 四 ， 属 于 类 地 行 
星 , 直径 约 为 地 球 的 53% 


木星 
木星 是 太阳 系 八大 行星 中 体积 最 大 、 自 转 最 快 的 行 
星 ， 排 行 第 五 。 它 的 质量 为 太阳 的 千 分 ,但 为 太 


火星 
火星 是 太阳 系 八大 行星 之 一 ， 排 行 第 四 ， 属 于 类 地 行 
星 , 直径 约 为 地 球 的 53% 


木星 

木星 是 太阳 系 八大 行星 中 体积 最 大 、 自 转 最 快 的 和 
星 ,排行 第 五 。 它 的 质量 为 
土星 

二 大 八大 行星 之 一 ,排行 第 六 ,体积 人 次 于 


土星 


土星 为 太阳 系 八大 行星 之 一 ， 排 行 第 六 ， 体 积 仅 次 于 
木星 














5-9 ”高 度 设置 为 match_parent 5-10 ”padding 显示 头 尾 分 隔 线 
既然 底部 和 顶部 的 分 隔 线 令 人 这 般 头 痛 , 不 如 直接 扔 掉 , 另外 想 想 别 的 办 法 。 使 用 padding 
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即 可 解决 这 个 问题 。 首 先 给 ListView 设置 背景 图 片 ， 然 后 分 别 设置 paddingTop 与 
paddingBottom， 接 下 来 项 部 和 底部 就 会 出 现 两 个 背景 图 的 padding， 有 具体 效果 如 图 5-10 所 示 。 

上 面 第 3 点 和 第 5 点 已 经 明确 是 Android 的 bug， 较 真 的 读者 不 必 把 时 间 浪 费 在 上 面 。 这 
不 是 设置 问题 ， 也 不 是 方法 调用 问题 ， 而 是 SDK 的 代码 逻辑 问题 ， 详 述 如 下 : 


(1) 关于 setDivider 方法 与 setDividerHeight 方法 的 先后 顺序 关系 , 参见 下 面 的 setDivider 
方法 源码 , 问题 在 于 让 条 件 , 这 里 “divider != null” 的 条 件 不 准确 , 应 当 改 为 “divider!=null && 
mpDividerHeight<=0”， 如 果 已 经 指定 分 隔 线 的 高 度 ， 就 不 使 用 分 隔 图 片 的 高 度 了 。 

public void setDivider(@Nullable Drawable divider) { 
让 (divider != null) { // 注意 这 里 的 判断 有 问题 
mDividerHeight = divider.getIntrinsicHeight(); 
}else{ 
mDividerHeight = 0; 
} 
mDivider = divider; 
mDividerIsOpaque = divider 一 null || divider.getOpacity() 一 PixelFormat.OPAQUE; 
TequestLayout(); 
invalidate(); 

(2) 关于 无 法 显示 顶部 的 分 阳线 问题 ， 可 查看 ListView 源码 的 dispatchDraw 方法 ， 这 里 

把 问题 代码 贴 出 来 了 ， 具 体 如 下 : 
boundstop = bottom; // 注意 这 里 的 设置 有 问题 ， 边 界 上 方 已 经 是 列表 项 的 底部 了 
bounds.bottom = bottom + dividerHeight; 














drawDivider(canvas, bounds, i); 

可 以 看 到 分 隔 线 固 定 在 该 项 底部 , 如 果 在 顶部 看 到 购物 车 = 
分 隔 线 ， 那 才 是 怪事 。 正 确 的 写法 是 对 顶部 的 分 隔 线 做 图 片 名 称 。。 政 量 单价 总 从 
分 支 处 理 ， 如 果 需 要 展示 项 部 的 分 隔 线 ， 就 给 :Wo vatet0 
bounds.bottom 赋值 为 child.getTop()， 给 bounds.top 赋 se | 
值 为 child.getTop()-dividerHeight。 ee 上 

幸好 ListView 的 这 些 毛病 都 是 小 问题 ， 不 影响 将 1 1 28992899 
其 发 扬 光 大 。 上 一 章 的 实战 项 目 一 一 购物 车 中 有 商品 列 蔡 
表 展 示 , 当时 采取 的 是 多 个 LinearLayout 依次 从 上 往 下 同 和 
排列 , 在 每 行 线性 布局 中 再 放 入 商品 图 片 、 名 称 、 价 格 四 
等 信息 , 该 做 法 在 代码 中 动态 添加 每 个 控件 ， 费时 费力 EE Pro6S 
而 且 容 易 出 错 。 这 种 情况 用 ListView 通过 适配器 显示 Roose 1 20982098 
商品 列表 更 合理 ， 具 体 的 代码 实现 过 程 与 BaseAdapter 加 
方式 类 似 ， 完 成 后 的 购物 车 页 面 效果 如 图 5-11 所 示 。 

在 实战 中 ，ListView 表现 得 还 不 是 很 完美 ， 有 3 怠 全 额 : 11694 结算 
个 地 方 要 特别 注意 : 


图 5-11 使 用 列表 视图 改造 后 的 购物 车 页 
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(1) 如 果 ListView 下 面 还 有 其 他 控件 ， 就 要 将 ListView 的 高 度 设 为 0dp， 权 重 设 为 1， 
确保 列表 视图 扩展 到 所 有 剩余 页 面 如 果 ListView 的 高 度 设置 为 wrap_content， 系统 就 只 预 留 
一 行 高 度 ， 如 此 一 来 只 有 第 一 行 显示 ， 这 显然 不 是 我 们 所 期 望 的 。 在 图 5-11 中 ， 注 意 到 结算 
行 位 于 页 面 底部 ， 就 是 因为 列表 视图 占据 了 页 面 的 剩余 空间 ， 导 致 结算 行 被 挤 到 最 下 面 了 。 

(2) 给 列表 项 注册 上 下 文 菜单 也 不 容易 ， 如 果 按照 之 前 对 上 下 文 菜单 的 操作 ， 长 按 列 表 
项 时 App 就 会 异常 退出 。 这 是 因为 上 下 文 菜 单 的 长 按 事 件 与 列表 项 的 长 按 监 听 器 
OnItemLongClickListener 相互 影响 ,使 得 程序 陷入 了 死 循环 。 最 后 的 处 理 办 法 是 要 把 两 种 长 按 
事件 阻隔 开 , 即 列表 项 长 按 事件 处 理 完毕 后 才 触 发 上 下 文 菜单 事件 , 打开 上 下 文 菜单 之 前 得 清 
空 列表 项 的 长 按 事 件 ， 具 体 代码 如 下 : 


private View mCurrentView;”// 声明 一 个 当前 视图 的 对 象 





/ 商品 项 的 长 按 事件 


public boolean onItemLongClick(AdapterView<?> parent, View view, int position, long id) { 
mCurrentGood = mCartArray.get(position); 
/ 保存 当前 长 按 的 列表 项 视图 


ImCurrentView = view; 


// 延迟 100 毫秒 后 执行 任务 mPopupMenu， 留 出 时 间 让 长 按 事件 走 完 流程 
mHandler.postDelayed(mPopupMenu, 100); 


Teturn true; 


} 


private Handler mHandler = new Handler(); / 声明 一 个 处 理 器 对 象 
// 定义 一 个 上 下 文 菜单 的 弹出 任务 


private Runnable mPopupMenu = 
public void run() { 


new Runnable() { 


1/ 取消 lv_cart 的 长 按 监听 器 
lv_cart.setOnItemLongClickListener(null); 

/ 注册 列表 项 视图 的 上 下 文 菜单 

registerForContext Menu(mCurrentView); 

// 为 该 列表 项 视图 弹出 上 下 文 菜单 
openContextMenu(mCurrentView); 

/ 注销 列表 项 视图 的 上 下 文 菜单 
UnregisterForContextMenu(mCurrentView); 

// 重新 设置 lv_cart 的 长 按 监 听 器 
lv_cart.setOnItemLongClickListener(ShoppingCartActivity.this); 


$s 


(3) 如 果 列 表 项 包含 EditText、Button (包括 ImageButton、CheckBox 等 按钮 ) 等 控件 ， 


介绍 EditText 时 提 到 页 面 会 自动 弹出 软 键盘 ， 就 是 EditText 抢占 焦点 造成 


的 。 同 理 ， 列 表 项 中 


如 果 存 在 EditText 和 Button， 这 些 子 控件 也 会 抢占 列表 项 的 焦点 ， 使 得 点 击 操作 被 视 为 对 


EditText 和 Button 的 点 击 ( 无 论点 

















昌 





5 处 是 否 落 在 EditText 和 Button 的 范 | 


内 ) ， 而 不 是 列表 
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项 的 点 击 。 解 决 办 法 是 给 列表 项 布局 文件 的 根 节 点 加 上 descendantFocusability 属性 , 并 声明 在 
列表 项 范围 内 剥夺 子 控件 的 抢占 权利 ， 有 具体 的 属性 设置 代码 如 下 : 
android:descendantFocusability="blocksDescendants" 


5.2.3 ”网 格 视图 GridView 


除了 列表 视图 , 网 格 视图 GridView 也 是 常见 的 适配器 视图 , 用 于 分 行 分 列 显示 表格 信息 ， 
比 ListView 更 适合 展示 商品 清单 。GridView 新 增 的 属性 与 方法 说 明 见 表 5-2。 
表 5-2 ”GriView 的 属性 与 方法 说 明 
XML 中 的 属性 GridView 类 的 设置 方法 | 说 明 





















horizontalSpacing “| setHorizontalSpacing 指定 网 格 项 在 水 平方 向 的 间距 

verticalSpacing setVerticalSpacing 指定 网 格 项 在 垂直 方向 的 间距 

numColumns setNumColumns 指定 列 的 数目 

stretchMode setStretchMode 指定 剩余 空间 的 拉 伸 模式 。 拉 伸 模 式 的 取 值 说 明 见 表 5-3 
columnWidth setColumnWidth 指定 每 列 的 宽度 。 拉 伸 模 式 为 spacingWidth、 





spacingWidthUniform 时 ， 必 须 指定 列 宽 


表 5-3 ” 拉 伸 模式 的 取 值 说 明 
XML 中 的 拉 伸 模式 ”| GridView 类 的 拉 伸 模式 说 明 
none NO_STRETCH 不 拉 伸 


columnWidth 车 有 剩余 空间 ， 则 拉 伸 列 宽 挤 掉 空 阶 


spacingWidth STRETCH_SPACING 车 有 剩余 空间 ， 则 列 宽 不 变 ， 把 空间 分 配 到 每 
spacingWidthUniform | STRETCH_SPACING_UNIFORM | 车 有 剩余 空间 ， 则 列 宽 不 变 ， 把 空间 分 配 到 每 


另外 ，GridView 实现 了 3 个 与 适配器 相关 的 方法 。 


e@ setAdapter: 设置 网 格 项 的 数据 适配器 ， 适 配器 一 般 继 承 BaseAdapter。 
esetOnItemClickListener: 设置 网 格 项 的 点 击 事件 监听 器 ， 用 法 同 ListView。 
e setOnItemLongClickListener: 设置 网 格 项 的 长 按 事 件 监 听 器 ， 用 法 同 ListView。 


可 以 看 到 ， 网 格 视图 不 像 列 表 视图 那样 有 指定 分 隔 线 的 方法 ， 但 这 并 不 意味 着 GridView 
就 没 法 设置 分 隔 线 。 通 过 变通 的 方式 也 能 给 GridView 设置 分 隔 线 。 有 具体 地 说 ， 就 是 先 给 
GridView 设置 背景 色 (例如 黑色 ) ， 以 及 网 格 之 间 的 水 平 间距 和 答 直 间距 ; 然后 给 网 格 项 设 
置 背 景色 (例如 白色 ) ， 这 样 只 有 网 格 间距 是 黑色 ， 从 而 间接 设置 了 黑色 的 分 隔 线 。 

下 面 是 演示 网 格 视图 分 隔 线 的 测试 代码 片段 : 


class DividerSelectedListener implements OnItemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
int dividerPad = Utils.dip2px(GridViewActivity.this, 2); // 定义 间隔 宽度 为 2dp 
gv_planet.setBackgroundColor(Color RED); // 设置 gv_planet 的 背景 颜色 
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gv_planetsetHorizontalSpacing(dividerPad); / 设置 gv_planet 的 水 平方 向 空白 

gv_planetsetVerticalSpacing(dividerPad); / 设置 gv_planet 的 垂直 方向 空白 

gv_planet.setStretchMode(GridView.STRETCH_COLUMN_WIDTH); // 设置 拉 伸 模式 

gv_planetsetColumnWidth(250); // 设置 gv_planet 的 每 列 宽度 为 250 

gv_planet.setPadding(0, 0, 0,0); / 设置 gv_planet 的 四 周 空白 

if(arg2 一 0){ // 不 显示 分 隔 线 
gv_planet.setBackgroundColor(Color WHITE); 
gv_planet.setHorizontalSpacing(0); 
gv_planet.setVerticalSpacing(0); 

} elseif(arg2 一 1){ // 只 显示 内 部 分 隔 线 (NO_STRETCH) 
gv_planet.setStretchMode(GridView.NO_STRETCH); 

} else if(arg2 一 2){ // 只 显示 内 部 分 隔 线 (COLUMN_WIDTH) 
gv_planet.setStretchMode(GridView.STRETCH_COLUMN_WIDTH); 

} else if(arg2 一 3){ / 只 显示 内 部 分 隔 线 (STRETCH_SPACING) 
gv_planet.setStretchMode(GridView.STRETCH_SPACING); 

} else if(arg2 一 4){ // 只 显示 内 部 分 隔 线 (SPACING_UNIFORM) 
gv_planet.setStretchMode(GridView.STRETCH_SPACING_UNIFORM); 

} else if(arg2 一 5){ // 显示 全 部 分 隔 线 〈 使 用 padding) 
gv_planet.setPadding(dividerPad, dividerPad, dividerPad, dividerPad); 


public void onNothingSelected(AdapterView<?> arg0) {} 
b 


接 下 来 观察 分 隔 线 的 测试 效果 ， 如 图 5-12 所 示 。 默 认 情况 下 ， 网 格 视图 没有 分 隔 线 ， 但 
通过 给 整个 视图 与 网 格 项 分 别 设置 背景 色 可 间接 实现 分 隔 线 ， 如 图 5-13 所 示 。 










分 隅 线 显示 不 显示 分 隔 线 
水 星 金星 


| 水星 是 太阳 系 八大 行星 最 内 侧 出 是 金星 是 太阳 系 八大 行星 之 
则 的 一生 ， 岂 是 高 太阳 并 近 第 一 A 






分 隔 线 显示 。 只 显示 内 部 分 阳线 (COLUMN_WIDTH) ~ 
金星 


旦 最 内 册 也 是 | 金星 是 太阳 系 作 大 行星 之 一 ， 排行 
也 是 元 太 阳 最 近 第 二 ,距离 太阳 0.725 天 文 单位 





火星 


一 , 排行 | 火星 是 大 下 系 八大 行星 之 一 ,排行 
呈 


排行 火星 是 太阳 系 八大 排行 
机 ee 直径 约 为 地 直入 的 为 地 


是 大 了 

地 的 
[有 大 全 /大 全 中 人 和 。 吉 本 为 大 人 定之 一， 
第 六 ， 伯 积 供 次 于 木星 











比 旦 为 太阴 系 八大 行星 之 一 ,排行 
车 六 ,体积 仅 次 于 木星 














它 的 质量 为 大! 
一 . 所 为 太阳系 中 其 它 七 大 行星 质 








图 5-12 没有 分 隔 线 效果 图 5-13” 拉 伸 模 式 为 columnWidth 
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图 5-13 所 示 的 分 隔 线 是 在 拉 伸 模 式 为 columnWidth 时 的 效果 , 这 也 是 最 常用 的 拉 伸 模式 。 
如 果 拉 伸 模 式 为 其 他 值 ， 间 距 效果 就 大 不 一 样 。 图 5-14 所 示 是 拉 伸 模式 为 none 时 的 界面 , 每 
行 右边 都 多 出 了 空隙 。 拉 伸 模 式 为 spacingWidth 时 ， 空 阶 均 匀 分 配给 每 列 之 间 的 间距 ， 即 变 
相 拉 大 了 horizontalSpacing， 具 体 效果 如 图 5-15 所 示 。 


分 限 线 旦 示 。 只 显示 内 部 分 隔 线 (NO_STRETCH) ~ | 分隔 线 呈 示 只 显示 内 部 分 隔 线 (STRETCH_SPACING) ~ 
水 星 金星 


水 旺 是 太阳系 八大 行星 最 万 全 | 入 县 是 太阳 系 八大 行 己 之 E 是 太阳系 几 
上 ， 排 划一， 下 丙 大 [ee ,也是 询 二 第 二 ,十 南 太 
msKxe 位 5 5 天文 单 位 


系 八 大 行星 之 。 | 时 是 太阳 系 八 大 行星 之 
中 上 ， 潮 行 四， 现 于 半 节 行 
展 ; 直 本 9 为 地 于 953% 


土星 


2 


此 呈 大 阳 素 八大 行 明之 
局 











5-14 拉 伸 模式 为 none 图 5-15 拉 伸 模式 为 spacingWidth 


拉 伸 模式 为 spacingWidthUniform 时 ， 分 配给 每 列 的 空隙 被 分 成 两 半 ， 一 半 加 到 网 格 项 的 
左边 ， 一 半 加 到 网 格 项 的 右边 ， 具 体 效果 如 图 5-16 所 示 。 这 样 看 来 ， 还 是 columnWidth 的 拉 
伸 最 符合 实际 ， 因 为 不 浪费 空间 。 然 而 GridView 的 间距 设置 跟 ListView 有 同样 的 毛病 ， 无 论 
是 horizontalSpacing 还 是 verticalSpacing， 都 设置 不 了 整个 网 格 视图 的 边缘 ， 也 就 是 对 四 周 的 
分 隔 线 依然 无 能 为 力 。 这 时 还 是 得 使 出 padding， 使 用 padding 能 对 付 不 同 的 对 象 ， 这 才能 体 
现 其 精妙 所 在 。 图 5-17 所 示 为 运用 padding 后 的 效果 图 。 










分 隔 线 显示 下 yi: 





金星 


末尾 是 大 阳 系 八大 行星 及 办 例 亿 是 | 金 是 是 太阳系 八大 行星 之 一 ， 指 行 
要 小 的 一 委 行 星 ,也 是 高 太阳 晤 过 | 秆 二 ,看 麻 太阳 0.725 天 文 单位 








地 球 火星 


涉 居 太阳系 八大 行星 之 一 ， 排行 | 火星 是 太阳 系 八 大 行星 之 一 ， 排 行 
三 ,也 是 太 卫 系 中 直径、 质量 和 | 第 四 ,属于 关 地 行星 ， 直 权 约 为 地 
这 总 大 的 类 地 行星 ， 得 奏 太 。 地 的 53% 





木星 土星 
2 


人 大宇 中 人 操办 提 天 人 和 之 一 ， 寺 和 
自转 所 的 行星 ,排行 贰 。 | 疡 六 ,体积 仅 次 于 木 
质量 太阳 的 人 之 





图 
元 因 一 .直行 第 二 .下 南大 
0 725 天 文 单位 
_ 国 
三 ， 也 是 大 限 和 ， 发 于 站 地 行 
“ 直 得 约 为 地 球 的 53% 
功 
,体积 促 次 于 林 


图 5-16” 拉 伸 模 式 为 spacingWidthUniform 图 5-17 padding 显示 四 周 分 隔 线 
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接 下 来 我 们 继续 在 实战 中 运用 GridView， 上 一 
节 的 列表 视图 已 经 成 功 改造 了 购物 车 的 商品 列表 , 现 
在 用 网 格 视图 改造 商品 频道 页 面 , 六 部 手机 正好 做 成 
三 行 两 列 的 GridView。 采 用 网 格 视图 改造 的 商品 频 
道 页 面 效果 如 图 5-18 所 示 。 

对 该 页 面 进行 功能 测试 时 ， 可 能 会 发 现 以 下 
问题 : 

(1) 网 格 项 内 有 一 个 “加 入 购物 车 ”按钮 ， 使 
得 网 格 项 的 点 击 事件 失效 (原本 点 击 网 格 项 跳 转 到 商 
品 详情 页 面 )。 这 个 问题 好 办 ， 前 面 介绍 ListView 
时 已 经 提 到 了 ， 原 因 是 网 格 项 的 焦点 被 按钮 抢占 了 ， 
解决 办 法 是 在 网 格 项 布局 的 根 节点 加 上 下 面 这 行 : 

android:descendantFocusability="blocksDescendants" 


(2) 点 击 “ 加 入 购物 车 ”按钮 ， 除 了 修改 数据 





小 米 6 opPoRI1 
a LL 





加 人 购物 车 3999 加 入 购物 车 





图 5-18 使 用 网 格 视图 改造 后 的 商品 频道 页 





库 外 ， 还 得 刷新 页 面 右 上 方 购物 车 图 标 上 的 数字 ， 相 当 于 适配器 把 消息 传 回 给 Activity。 对 于 


这 个 问题 ， 可 借鉴 点 击 监 听 器 的 做 法 ， 具 体 步 又 如 下 : 


ET 定义 一 个 监听 器 接口 addCartListener， 在 适配器 的 构造 函数 中 传 入 该 监听 器 的 对 象 ， 


示例 代码 如 下 : 





// 商品 适配器 的 构造 函数 ， 传 入 上 下 文 、 行 星 队列 与 加 入 购物 车 监听 器 
public GoodsAdapter(Context context, ArrayList<GoodsInfo> goods_list addCartListener listener) { 


mContext = context; 

mGoodsArray = goods_list; 

mAddCartListener = listener; 
b 


// 声明 一 个 加 入 购物 车 的 监听 器 对 象 
private addCartListener mAddCartListener; 
// 定义 一 个 加 入 购物 车 的 监听 器 接口 
public interface addCartListener { 


void addToCart(long goods id); / 在 商品 加 入 购物 车 时 触发 





E302 使 用 适配器 处 理 *< 加 入 购物 车 ”按钮 的 点 击 操作 时 ,调用 监听 器 的 内 部 方法 addToCart， 











示例 代码 如 下 : 


holder.btn_add.setOnClickListener(new OnClickListenerO { 


public void onClick(View v) { 
/ 触发 加 入 购物 车 监听 器 的 添加 动作 


mAddCartListener.addToCart(info.rowid); 
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D; 


303 Activity 的 页 面 代码 要 实现 addCartListener 接口 的 addToCart 方法 ， 进 行 对 应 的 购物 
车 业务 逻辑 处 理 ， 同 时 记 住 往 适配器 的 构造 函数 传 入 该 监听 器 的 对 象 。 

















5.3” 翻 页 类 视图 


本 节 介 绍 如 何在 页 面 上 运用 翻 页 类 视图 ， 包 括 翻 页 视图 ViewPager 配合 翻 页 适配器 
PagerAdapter 的 用 法 、 翻 页 标题 栏 PagerTitleStrip/PagerTabStrip 的 用 法 ， 最 后 结合 实战 演示 使 
用 ViewPager 实现 简单 的 启动 引导 页 效果 。 


5.3.1 翻 页 视图 ViewPager 


上 一 节 介 绍 的 ListView 与 GridView， 一 个 分 行 展示 ， 另 一 个 分 行 又 分 列 ， 其 实 都 是 在 垂 
直方 向 上 下 滑动 。 有 没有 一 种 控件 允许 页 面 在 水 平方 向 左右 滑动 ， 就 像 翻 书 、 翻 报纸 一 样 呢 ? 
对 于 这 种 左右 滑动 的 翻 页 功能 ，Android 提供 了 已 经 封装 好 的 控件 ， 就 是 翻 页 视图 ViewPager。 
对 于 ViewPager 来 说 ， 一 个 页 面 就 是 一 个 项 (相当 于 ListView 的 一 个 列表 项 ) ， 许 多 页 面 组 
成 ViewPager 的 页 面 项 。 

明确 了 ViewPager 的 原理 类 似 ListView 和 GridView， 翻 页 视图 的 用 法 也 与 它 俩 类 似 。 
ListView 和 GridView 的 适配器 使 用 BaseAdapter，ViewPager 的 适配器 使 用 PagerAdapter; 
ListView 和 GridView 的 监听 器 使 用 OnItemClickListener，ViewPager 的 监听 器 使 用 
OnPageChangeListener， 表 示 监 听 页 面 切换 事件 。 

下 面 是 ViewPager 三 个 常用 方法 的 说 明 。 


e@ setAdapter: 设置 页 面 项 的 适配器 。 适 配器 用 的 是 PagerAdapter 及 其 子 类 。 

esetCurrentItem: 设置 当前 页 码 ， 即 打开 翻 页 视图 时 默认 显示 哪个 页 面 。 

。 addOnPageChangeListener: 设置 翻 页 视图 的 页 面 切换 监听 器 。 该 监听 器 需 实现 接口 
OnPageChangeListener 下 的 3 个 方法 ， 具 体 说 明 如 下 。 


> onPageScrollStateChanged: 在 页 面 滑动 状态 变化 时 触发 。 
> onPageScrolled: 在 页 面 滑动 过 程 中 触发 。 
> onPageSelected: 在 选中 页 面 时 ， 即 滑动 结束 后 触发 。 


翻 页 适配器 PagerAdapter 与 基本 适配器 BaseAdapter 的 用 法 相近 ， 需 实现 构造 函数 、 获 取 
页 面 个 数 的 getCount 方法 、 生 成 单个 页 面 视图 的 instantiateltem 方法 ， 另 外 多 了 一 个 回收 页 面 
的 destroyItem 方法 。 下 面 是 使 用 PagerAdapter 的 代码 例子 : 


public class ImagePagerAdapater extends PagerAdapter { 
private Context mContext; // 声明 一 个 上 下 文 对 象 
// 声明 一 个 图 像 视图 队列 
private ArrayList<ImageView> mViewList = new ArrayList<Image View>(); 
// 声明 一 个 商品 信息 队列 
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private ArrayList<GoodsInfo> mGoodsList = new ArrayList<GoodsInfo>(); 


// 图 像 翻 页 适配器 的 构造 函数 ， 传 入 上 下 文 与 商品 信息 队列 
public ImagePagerA dapater(Context context, ArrayList<GoodsInfo> goodsList) { 
mContext = context; 
mGoodsList = goodsL ist; 
/ 给 每 个 商品 分 配 一 个 专用 的 图 像 视图 
for (inti= 0;i< mGoodsList.size(); i++) { 
ImageView view = new ImageView(mContext); 
View.setLayoutParams(new LayoutParams( 

LayoutParams.MATCH PARENT, LayoutParams.WRAP CONTENT)); 
View.setImageResource(mGoodsList.get(i).pic); 
View.setScaleType(ScaleType.FIT_ CENTER); 

/ 把 该 商品 的 图 像 视图 添加 到 图 像 视图 队列 


mViewList.add(view); 


/ 获取 页 面 项 的 个 数 
public int getCount() { 
return mViewList.size(); 


(@Override 
public boolean isViewFromObject(View arg0, Object arg1) { 
Teturn arg0 一 argl; 


// 从 容器 中 销毁 指定 位 置 的 页 面 
public void destroyItem(ViewGroup container, int position, Object object) { 
container.remove View(m ViewList.get(position)); 


/ 实例 化 指定 位 置 的 页 面 ， 并 将 其 添加 到 容器 中 

public Object instantiateltem(ViewGroup container, int position) { 
container.addView(mViewList.get(position)); 
return mViewList.get(position); 


1 
与 适配器 ImagePagerAdapater 对 应 的 页 面 代码 如 下 : 


public class ViewPagerActivity extends AppCompatActivity implements OnPageChangeListener { 
Private ArrayList<GoodsInfo> goodsL ist; 
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protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_view_pager); 
goodsList = GoodsInfo.getDefaultList(); 
/ 构建 一 个 商品 图 片 的 翻 页 适配器 
ImagePagerA dapater adapter = new ImagePagerAdapater(this, goodsList); 
// 从 布局 视图 中 获取 名 叫 vp_content 的 翻 页 视图 
ViewPager vp_content = findViewById(R.id.vp_content); 
/ 给 vp_content 设置 图 片 翻 页 适配器 
Vvp_content.setAdapter(adapter); 
/ 设置 vp_content 默认 显示 第 一 个 页 面 
vp_content.setCurrentItem(0); 
// 给 vp_content 添加 页 面 变化 监听 器 
vp_content.addOnPageChangeListener(this); 

b 


// 翻 页 状态 改变 时 触发 。arg0 取 值 说 明 为 : 0 表示 静止 ，1 表示 正在 滑动 ，2 表示 滑动 完毕 


// 在 翻 页 过 程 中 ， 状 态 值 变化 依次 为 : 正在 滑动 一 滑动 完毕 一 静止 
public void onPageScrollStateChanged(int arg0) {} 


// 在 翻 页 过 程 中 触发 。 该 方法 的 三 个 参数 取 值 说 明 为 : 第 一 个 参数 表示 当前 页 面 的 序号 
/ 第 二 个 参数 表示 当前 页 面 偏 移 的 百分比 ， 取 值 为 0 到 1; 第 三 个 参数 表示 当前 页 面 的 偏 移 距 离 


public void onPageScrolled(int arg0, float argl, int arg2) {} 


/ 在 翻 页 结束 后 触发 。arg0 表示 当前 滑 到 了 哪 一 个 页 面 
public void onPageSelected(int arg0) { 
Toast.makeText(this, "您 翻 到 的 手机 品牌 是 : "+ goodsList.get(arg0).name, 
ToastLENGTH SHORT).show0); 
} 


下 面 是 页 面 代码 对 应 的 布局 文件 代码 , 注意 ViewPager 的 节点 名 必须 引用 v4 包 的 全 路 径 ， 


即 android.support.v4.view.ViewPager。 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" 
android:padding="10dp" > 


<!-- 注意 翻 页 视图 ViewPager 的 节点 名 称 要 填 全 路 径 --> 
<android.supportv4.view.ViewPager 
android:id="(@+id/vp_content" 
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android:layout_ width="match parent" 
android:layout_height="400dp" 亡 
</LinearLayout> 


具体 的 翻 页 效果 如 图 5-19 所 示 。 截 图 的 瞬间 ，ViewPager 正在 左右 两 个 页 面 之 间 滑 动 。 


senior 








图 5-19 翻 页 视图 滚动 瞬间 
5.3.2” 翻 页 标题 栏 PagerTitleStrip/PagerTabStrip 


为 了 方便 开发 者 处 理 ViewPager 的 页 码 显示 与 切换 ，Android 附带 提供 了 两 个 控件 ， 分 别 

是 PagerTitleStrip 和 PagerTabStrip。 二 者 都 是 在 ViewPager 页 面 上 方 展示 设 定 的 页 面 标题 ， 不 
同 之 处 在 于 PagerTitleStrip 只 是 单纯 的 文本 标题 效果 ， 无 法 点 击 进行 页 面 切换 ，PagerTabStrip 
类 似 选项 卡 效 果 , 文本 下 面 有 横 线 ,点 击 左右 选项 卡 即 可 切换 到 对 应 页 面 。 要 想 在 标题 栏 显 示 
指定 的 文字 ， 得 重 写 PagerAdapter 的 getPageTitle 方法 ， 在 这 方面 两 个 控件 的 处 理 是 一 样 的 ， 
示例 代码 如 下 : 

/ 获得 指定 页 面 的 标题 文本 

@Override 

public CharSequence getPageTitle(int position) { 

return mGoodsList.get(position).name; 





b 
下 面 是 在 布局 文件 中 添加 PagerTitleStrip 的 代码 ， 注 意 PagerTitleStrip 的 节点 名 必须 引用 
v4 包 的 全 路 径 ， 即 android.supportv4.view.PagerTitleStrip 。 如 果 用 PagerTabStrip ， 就 把 
PagerTitleStrip 改 为 PagerTabStrip 。 
<LinearLayout xmlns:android="http://schemas.android.com/apkjres/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" 
android:padding="10dp" > 


<!-- 注意 翻 页 视图 ViewPager 的 节点 名 称 要 填 全 路 径 --> 
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| 
<android.support.v4.view.ViewPager 
android:id="(@+id/vp_content" 
android:layout_width="match parent" 
android:layout_height="400dp" > 


<!-- 注意 翻 页 标题 栏 PagerTitleStrip 的 节点 名 称 要 填 全 路 径 --> 
<android.support.v4.view.PagerTitleStrip 
android:id="@+id/pts_title" 
android:layout_ width="wrap_content" 
android:layout_height="wrap_content" /> 
</android.support.v4.view.ViewPager> 
</LinearLayout> 


翻 页 标题 栏 的 显示 界面 很 简单 ， 正 上 方 是 当前 页 面 的 标题 ， 左 上 方 是 左边 页 面 的 标题 ， 
右上 方 是 右边 页 面 的 标题 。PagerTitleStrip 的 标题 只 有 文字 ， 如 图 5-20 所 示 。PagerTabStrip 除 


了 文字 还 有 下 划 线 ， 如 图 5-21 所 示 。 


Senlor 


iPhone8 Mate10 





图 5-20 PagerTitleStrip 的 效果 图 5-21 ”PagerTabStrip 的 效果 





标题 栏 因 为 只 有 文本 ， 所 以 调整 样式 只 能 改 改 文字 的 大 小 与 颜色 。 注 意 这 两 个 控件 没 法 


在 布局 文件 中 修改 文字 样式 , 因为 没有 对 应 的 样式 属性 ,只 能 在 代码 中 调用 文本 样式 
法 ， 具 体 的 代码 如 下 : 
/ 初始 化 翻 页 标题 栏 
Private void initPagerStrip() { 
// 从 布局 视图 中 获取 名 叫 pts_tab 的 翻 页 标题 栏 
PagerTabStrip pts_tab = findViewById(R.id.pts_tab); 
// 设置 翻 页 标题 栏 的 文本 大 小 
pts_tab.setTextSize(TypedValue.COMPLEX_UNIT SP, 20); 
/ 设置 翻 页 标题 栏 的 文本 颜色 
pts_tab.setTextColor(Color. GREEN); 





的 设置 方 
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5.3.3 简单 的 启动 引导 页 


ViewPager 的 应 用 很 广 ， 当 用 户 安装 一 个 新 的 App 时 ， 第 一 次 启动 大 多 出 现 欢 迎 页 面 ， 这 
个 引导 页 通常 要 往 右 翻 好 几 页 , 才 会 进入 App 的 主页 面 。 启 动 引 导 页 的 效果 大 多 是 ViewPager 
做 的 。 

下 面 就 来 动手 打造 你 的 第 一 个 App 启动 欢迎 页 吧 !ViewPager 技术 的 核心 在 于 页 面 项 的 布 
局 及 其 适配器 ， 因 此 首先 要 设计 页 面 项 的 布局 。 一 般 来 说 ， 引 导 页 主要 由 两 部 分 组 成 ， 一 部 分 
是 背景 图 ; 另 一 部 分 是 页 面 下 方 的 一 排 圆 点 指示 器 ,高 亮 的 圆 点 表示 当前 位 于 第 几 页 。 具 体 效 
果 如 图 5-22 与 图 5-23 所 示 。 其 中 ,图 5-22 所 示 为 欢迎 页 面 的 第 一 页 图 5-23 所 示 为 第 二 页 ， 
高 亮 圆 点 移 到 第 二 个 。 





生活 ， 精 挑 细 选 





图 5-22 ”欢迎 页 的 第 一 页 图 5-23 ”欢迎 页 的 第 二 页 
除了 背景 图 与 一 排 圆 点 ， 最 后 一 页 往往 有 一 个 按钮 ， 是 进入 主页 面 的 入 口 。 页 面 项 的 布 
局 文件 至 少 有 3 个 控件 : 引导 页 的 背景 图 (采用 ImageView) 、 底 部 的 一 排 圆 点 指示 器 (可 采 
用 RadioGroup) 、 最 后 一 页 的 入 口 按钮 (采用 Button) ， 详 细 的 代码 如 下 : 
<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 





<!-- 这 是 引导 图 片 的 图 像 视图 --> 

<ImageView 
android:id="(@+id/iv_launch" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scaleType="fitXY" /> 
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<!-- 这 是 引导 页 底部 的 圆 点 指示 器 -> 

<RadioGroup 
android:id="(@+id/rg_indicate" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android:layout_centerHorizontal="true" 
android:layout_gravity="bottom|center" 
android:orientation="horizontal" 
android:paddingBottom="20dp" 亡 


<!-- 这 是 最 后 一 页 的 入 口 按钮 -> 

<Button 
android:id="@+id/btn_start" 
android:layout_ width="match_parent" 
android:layout_height="wrap_content" 
android:layout_marginLeft="80dp" 
android:layout_marginRight="80dp" 
android:layout_centerInParent="true" 
android:gravity="center" 
android:text=" 立 即 开 始 美好 生活 " 
android:textColor="#ff3300" 
android:textSize="22sp" 
android:visibility="gone" />" 

</RelativeLayout> 


根据 该 布局 文件 ， 引 导 页 的 最 后 两 个 页 面 如 图 5-24 与 图 5-25 所 示 。 其 中 ,图 5-24 是 第 3 
个 页 面 ， 高 亮 圆 点 移 到 第 3 个 ;图 5-25 是 最 后 一 个 页 面 ， 只 有 该 页 才 会 显示 入 口 按钮 。 


《全 


J 
支付 简单 点 一 





图 5-24 ”欢迎 页 的 第 三 页 图 5-25 ”欢迎 页 的 最 后 一 页 
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启动 引导 页 的 适配器 代码 主要 工作 是 根据 布局 文件 构造 每 页 的 视图 ， 然 后 把 当前 页 码 的 














点 设置 高 亮 ， 如 果 是 最 后 一 页 就 显示 入 口 按钮 ， 具 体 代 码 如 下 : 


public class LaunchSimpleAdapter extends PagerAdapter { 
private Context mContext; // 声明 一 个 上 下 文 对 象 
private ArrayList<View> mViewList = new ArrayList<View>0:; // 声明 一 个 引导 页 的 视图 队列 


// 引导 页 适配器 的 构造 函数 ， 传 入 上 下 文 与 图 片 数 组 
public LaunchSimpleAdapter(Context context, int[] imageArray) { 
mContext = context; 
for (inti= 0; i< imageArray.length; i++) { 
/ 根据 布局 文件 item_launch.xml 生成 视图 对 象 
View view = LayoutInflater.from(context).inflate(R.layout.item_launch, nulD); 
ImageView iv_launch = view.findViewById(R.id.iv_launch): 
RadioGroup rg_indicate = view.findViewById(R.id.rg_indicate); 
Button btn_start = view.findViewByld(R.id.btn_start); 
// 设置 引导 页 的 全 屏 图 片 
iv_launch.setImageResource(imageArray[i]); 
// 每 张 图 片 都 分 配 一 个 对 应 的 单 选 按 钮 RadioButton 
for (intj = 0; j < imageAmray.length; j++) { 
RadioButton radio = new RadioButton(mContext); 
radio.setLayoutParams(new LayoutParams( 

LayoutParams.WRAP_ CONTENT, LayoutParams.WRAP_CONTENT)); 
radio.setButtonDrawable(R.drawable.launch_guide): 
radio.setPadding(10, 10, 10, 10); 

// 把 单 选 按钮 添加 到 底部 指示 器 的 单 选 组 
rg_indicate.addView(radio); 
} 
// 当前 位 置 的 单 选 按钮 要 高 亮 显示 ， 比 如 第 二 个 引导 页 就 高 亮 第 二 个 单 选 按钮 
((RadioButton) rg_indicate.getChildAt(i)).setChecked(true); 
// 如 果 是 最 后 一 个 引导 页 ， 则 显示 入 口 按钮 ， 以 便 用 户 点 击 按钮 进入 首页 
if(i 一 imageArray.length- 1) { 
btn_start.setVisibility(View.VISIBLE); 
btn_start.setOnClickListener(new OnClickListener() { 
(@Override 
public void onClick(View v) { 
Toast.makeText(mContext, "欢迎 您 开启 美好 生活 ", 
ToastLENGTH SHORT).show(); 


D); 
} 
/ 把 该 图 片 对 应 的 引导 页 添加 到 引导 页 的 视图 队列 
mViewList.add(view); 
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上 
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/ 获取 页 面 项 的 个 数 
public int getCount() { 

return mViewList.size(); 
! 


@Override 

public boolean isViewFromObject(View arg0, Object argl) { 
return arg0 一 argl; 

) 


/ 从 容器 中 销毁 指定 位 置 的 页 面 

public void destroyItem(ViewGroup container int position, Object object) { 
container.remove View(m ViewList.get(position)); 

} 


// 实例 化 指定 位 置 的 页 面 ， 并 将 其 添加 到 容器 中 

public Object instantiateltem( ViewGroup container, int position) { 
container.addView(mViewList.get(position)); 
return mViewL ist.get(position); 


5.4 碎片 Fragment 


本 节 介绍 如 何在 页 面 上 加 入 碎片 并 合理 使 用 ,包括 通过 静态 注册 方式 使 用 碎片 Fragment、 
通过 动态 注册 方式 配合 碎片 适配器 FragmentStatePagerAdapter 使 用 Fragment, 并 分 别 分 析 两 种 


注册 方式 的 Fragment 生命 周期 ， 最 后 结合 实战 使 用 Fragment 对 启动 引导 页 进行 改进 。 
5.4.1 静态 注册 


Fragment 是 个 特别 的 存在 ， 有 点 像 报 纸 上 的 专栏 ， 看 起 来 只 占据 页 面 的 一 小 块 ， 但 是 这 一 
小 块 有 自己 的 生命 周期 ， 可 以 自行 其 事 ， 仿 佛 独立 王国 ， 并 且 这 一 小 块 的 特性 无 论 在 哪个 页 面 ， 





给 一 个 位 置 就 行 ， 添 加 后 不 影响 宿主 页 面 的 其 他 区 域 ， 去 除 后 也 不 影响 宿主 页 面 的 其 他 


区 域 。 





每 个 Fragment 都 有 对 应 的 布局 文件 ， 依 据 其 使 用 方式 可 分 为 静态 注册 与 动态 注册 两 类 。 
静态 注册 是 在 布局 文件 中 直接 放置 fragment 节点 ， 类 似 于 一 个 普通 控件 ， 可 被 多 个 布局 文件 
同时 引用 。 静 态 注册 一 般 用 于 某 个 通用 的 页 面部 件 ( 如 Logo 条 、 广 告 条 等 ) ， 每 个 活动 页 面 


均 可 直接 引用 该 部 件 。 
下 面 是 Fragment 布局 文件 的 代码 ， 看 起 来 跟 列 表 项 与 网 格 项 的 布局 文件 差不多 。 
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<LinearLayout xmlIns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match parent" 
android:layout_height="wrap_content" 
android:orientation="horizontal" 
android:background="#bbffbb" > 


<TextView 
android:id="(@+id/tv_adv" 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="1" 
android:gravity="center" 
android:text=" 广 告 " 
android:textColor="#000000" 
android:textSize="17sp" /> 


<ImageView 

android:id="(@+id/iv_adv" 
android:layout_width="0dp" 
android:layout_height="wrap_content" 
android:layout_weight="5" 
android:src="(@drawable/adv" 
android:scaleType="fitCenter" /> 

</LinearLayout> 


下 面 是 与 上 述 布局 对 应 的 Fragment 代码 ， 除 了 继承 自 Fragment 外 ， 其 他 地 方 很 像 活动 页 
而 代码 。 


public class StaticFragment extends Fragment implements OnClickListener { 
protected View mView; / 声明 一 个 视图 对 象 
protected Context mContext; // 声明 一 个 上 下 文 对 象 


/ 创建 碎片 视图 
public View onCreate View(LayoutInflater inflater ViewGroup container, Bundle savedInstanceState) { 
mContext = getActivity(); / 获取 活动 页 面 的 上 下 文 
/ 根据 布局 文件 fragment_static.xml 生成 视图 对 象 
mView = inflater.inflate(R.layout.fragment_static, container false); 
TextView tv_adv = mView.findViewById(R.id.tv_adv); 
ImageView iv adv = mView.findViewById(R.id.iv_adv); 
tv_adv.setOnClickListener(this); 
iv_adv.setOnClickListener(this); 
Teturn mView; / 返回 该 碎片 的 视图 对 象 
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@Override 
public void onClick(View v) { 
if (vgetId) = Rid.tv_adv) { 
ToastmakeText(mContext "您 点 击 了 广告 文本 ", Toast.LENGTH_LONG).showO; 
} elseif(v.getId0 一 R.id.iv_adv) { 
Toast.makeText(mContext, "您 点 击 了 广告 图 片 ", Toast.LENGTH_LONG).show0; 


} 


若 想 在 页 面 布局 文件 中 引用 Fragment， 则 可 直接 加 入 一 个 fragment 节点 ， 注 意 fragment 
节点 要 增加 name 属性 指定 该 Fragment 类 的 完整 路 径 。 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" 
android:padding="Sdp"> 


<!-- 把 碎片 当 作 一 个 控件 使 用 ， 其 中 android:name 指明 了 碎片 来 源 -~ 
<fragment 
android:id="@+id/fragment_static” 
android:name="com.example.senior.fragment. StaticFragment" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" /> 


<TextView 

android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:gravity="centerltop" 
android:text=" 这 里 是 每 个 页 面 的 具体 内 容 " 
android:textColor="#000000" 
android:textSize="17sp" /> 

</LinearLayout> 


最 后 运行 并 查看 页 面 效果 , 如 图 5-26 所 示 。 此 时 Fragment 界面 给 人 的 感觉 就 像 一 个 视图 ， 
同样 可 以 接收 点 击 事件 。 








7 A 
用 心服 务 ' 
广告 和 心服 : ( GA 


这 里 是 每 个 页 面 的 具体 内 容 





图 5-26 静态 注册 的 Fragment 效果 
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使 用 静态 注册 需要 注意 以 下 两 点 : 


(1)fragment 节点 必须 指定 id 属性 , 否则 App 运行 时 会 报错 Must specify unique android:id， 
android:tag, or have a parent with an id for ***。 

(2) 如 果 页 面 代码 继承 自 Activity，Fragment 类 就 必须 继承 自 android.app.Fragment， 不 
能 使 用 android.supportv4.app.Fragment， 和 否则 App 运行 会 报错 Trying to instantiate a class *** 
that is not a Fragment 或 报错 java.lang.ClassCastException : *** cannot be cast to 
android.app.Fragment; 如 果 页 面 代码 继承 自 AppCompatActivity 或 FragmentActivity， 那 么 无 论 
是 android.app.Fragment 还 是 android.support.v4.app.Fragment 都 可 以 使 用 。 


另外 ， 介 绍 一 下 Fragment 在 静态 注册 时 的 生命 周期 ， 如 Activity 的 基本 生命 周期 方法 
onCreate、onStart、onResume、onPause、onStop、onDestroy， 碎 片 Fragment 都 有 ， 而 且 还 多 
出 了 下 面 5 个 生命 周期 方法 。 


e@ onAttach: 与 Activity 结合 .可 在 该 方法 中 实例 化 Activity 的 一 个 回调 对 象 , 在 Fragment 
中 调用 Activity 的 回调 方法 。 这 样 设计 的 好 处 是 Activity 无 须 调用 set***Listener 方法 
设置 监听 器 接口 。 

onCreateView: 创建 碎片 视图 。 

onActivityCreated: 在 活动 页 面 创建 完毕 后 调用 。 

onDestroyView: 回收 碎片 视图 。 

onDetach: 与 Activity 分 离 。 


至 于 这 些 周期 方法 的 先后 调用 顺序 ， 观 察 日 志 最 简单 明了 。 下 面 是 打开 页 面 时 的 日 志 信 
息 , 此 时 Fragment 的 onCreate 操作 先 于 Activity, 而 onStart 与 onResume 操作 在 Activity 之 后 。 


12:26:11.506: D/StaticFragment(5809): onAttach 
12:26:11.506: D/StaticFragment(5809): onCreate 
12:26:11.530: D/StaticFragment(5809): onCreateView 
12:26:11.530: D/FragmentStaticActivity(5809): onCreate 
12:26:11.530: D/StaticFragment(5809): onActivityCreated 
12:26:11.530: D/FragmentStaticActivity(5809): onStart 
12:26:11.530: D/StaticFragment(5809): onStart 
12:26:11.530: D/FragmentStaticActivity(5809): onResume 
12:26:11.530: D/StaticFragment(5809): onResume 





© 0 0 9。 


下 面 是 退出 页 面 时 的 日 志 信 息 , 此 时 Fragment 的 onPause、onStop、onDestroy 都 在 Activity 


之 前 。 


12:26:36.586: D/StaticFragment(5809): onPause 
12:26:36.586: D/FragmentStaticActivity(5809): onPause 
12:26:36.990: D/StaticFragment(5809): onStop 
12:26:36.990: D/FragmentStaticActivity(5809): onStop 
12:26:36.990: D/StaticFragment(5809): onDestroyView 
12:26:36.990: D/StaticFragment(5809): onDestroy 
12:26:36.990: D/StaticFragment(5809): onDetach 
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12:26:36.990: D/FragmentStaticActivity(5809): onDestroy 


总 结 一 下 ， 在 静态 注册 时 ， 除 了 碎片 的 创建 操作 在 页 面 创建 之 前 ， 其 他 操作 都 在 页 面 创 
建 之 后 。 就 像 老实 本 分 的 下 级 ， 上 级 开 腔 后 才能 说 话 ， 上 级 要 做 总 结 性 发 言 时 赶紧 闭 嘴 。 


5.4.2 ”动态 注册 /碎片 适配器 FragmentStatePagerAdapter 





Fragment 拥有 两 种 使 用 方式 ， 即 静态 注册 和 动态 注册 。 相 比 静 态 注册 ， 实 际 开发 中 动态 
注册 用 得 更 多 。 融 态 注 册 在 布局 文件 中 直接 指定 Fragment， 而 动态 注册 直到 在 代码 中 才 动 态 
添加 Fragment。 动 态 生成 的 碎片 给 谁 用 、 要 怎么 用 呢 ? 毫 无 疑问 ， 动 态 碎片 就 是 给 翻 页 视图 
用 的 ，ViewPager 和 Fragment 是 一 对 好 搭档 。 

怎么 在 ViewPager 中 使 用 Fragment, 关键 在 于 适配器 。 上 一 节 演 示 ViewPager 时 用 的 适 配 
器 是 翻 页 适配器 PagerAdapter 。 如 果 结 合 Fragment， 适 配器 就 要 改 用 碎片 适配器 
FragmentStatePagerAdapter。 下 面 是 使 用 FragmentStatePagerAdapter 适配器 的 代码 ， 获 取 页 面 
视图 的 地 方 变 成 了 getItem 方法 。 

public class MobilePagerAdapter extends FragmentStatePagerAdapter { 

private ArrayList<GoodsInfo> mGoodsList = new ArrayList<GoodsInfo>(); / 声明 一 个 商品 队列 


// 碎片 页 适配器 的 构造 函数 ， 传 入 碎片 管理 器 与 商品 信息 队列 

public MobilePagerAdapter(FragmentManager fm, ArrayList<GoodsInfo> goodsList) { 
super(fim); 
mGoodsList = goodsList; 


/ 获取 碎片 Fragment 的 个 数 
public int getCountO { 
return mGoodsList.size(); 


b 


// 获取 指定 位 置 的 碎片 Fragment 
public Fragment getItem(int position) { 
return DynamicFragment.newInstance(position, 
mGoodsList.get(position).pic, mGoodsList.get(position).desc); 
上 


/ 获得 指定 碎片 页 的 标题 文本 

public CharSequence getPageTitle(int position) { 
return mGoodsList.get(position).name; 

上 


以 上 适配器 在 获得 碎片 对 象 时 不 用 构造 函数 , 却 用 了 newInstance 方法 , 目的 是 给 Fragment 
传递 参数 信息 。 通 过 构造 函数 获得 碎片 对 象 后 还 得 调用 setArguments 方法 才能 把 请 求 数据 塞 
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进去 , 然后 在 Fragment 的 onCreateView 函数 中 调用 getArguments 方 获得 请 求 数 据 。 下 面 是 动 
态 注册 的 碎片 代码 : 


public class DynamicFragment extends Fragment { 
protected View mView;”// 声明 一 个 视图 对 象 
protected Context mContext; // 声明 一 个 上 下 文 对 象 
private int mPosition; // 位 置 序号 
private int mImageld; / 图 片 的 资源 编号 
private String mDesc; // 商品 的 文字 描述 


// 获取 该 碎片 的 一 个 实例 

public static DynamicFragment newInstance(int position, int image_id, String desc) { 
DynamicFragment fragment = new DynamicFragment(); / 创建 该 碎片 的 一 个 实例 
Bundle bundle = new Bundle0; / 创建 一 个 新 包 囊 
bundle.putInt("position", position); / 往 包 里 存 入 位 置 序号 
bundle.putInt("image_id", image_id); // 往 包裹 存 入 图 片 的 资源 编号 
bundle.putString("desc", desc); / 往 包 囊 存 入 商品 的 文字 描述 
fragment.setArguments(bundle); / 把 包 囊 塞 给 碎片 
return fragment; / 返回 碎片 实例 

) 


/ 创建 碎片 视图 
public View onCreateView(LayoutInflater inflater ViewGroup container, Bundle savedInstanceState) { 
mContext = getActivity(0); / 获取 活动 页 面 的 上 下 文 
让 (getArguments() != null) { // 如 果 碎 片 携带 有 包 衷 ， 则 打开 包 衷 获取 参数 信息 
mPosition = getArguments().getInt("position", 0); 
mImageld = getArguments().getInt("image_id", 0); 
mDesc = getArguments().getString("dese"); 
} 
/ 根据 布局 文件 fragment_dynamic.xml 生成 视图 对 象 
mView = inflaterinflate(R.layoutfragment_ dynamic, container, false); 
ImageView iv_pic = mView.findViewById(R.id.iv_pic); 
TextView tv_desc = mView.findViewById(R.id.tv_desc); 
iv_pic.setImageResource(mImageId); 
tv_desc.setText(mDesc); 
Teturn mView; / 返回 该 碎片 的 视图 对 象 


} 

现在 有 了 适用 于 动态 注册 的 适配器 与 碎片 对 象 ， 还 需要 一 个 主页 面 配合 才能 完成 整个 页 
面 的 展示 。 下 面 是 动态 注册 用 到 的 页 面 代 码 ， 注 意 这 里 不 能 继承 Activity， 只 能 继承 
AppCompatActivity 或 FragmentActivity 。 








public class FragmentDynamicActivity extends AppCompatActivity { 


172 | Android Studio 开发 实战 : 从 零 基础 到 App 上 线 (第 2 版 ) 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_fragment dynamic); 
ArrayList<GoodsInfo> goodsList = GoodsInfo.getDefaultList(); 
/ 构建 一 个 手机 商品 的 碎片 翻 页 适配器 
MobilePagerAdapter adapter = new MobilePagerAdapter( 

getSupportFragmentManager(), goodsList); 

// 从 布局 视图 中 获取 名 叫 vp_content 的 翻 页 视图 
ViewPager vp_content = findViewById(R.id.vp_content); 
/ 给 vp_content 设置 手机 商品 的 碎片 适配器 
vp_content.setAdapter(adapter); 
/ 设置 vp_content 默认 显示 第 一 个 页 面 
vp_content.setCurrentItem(0); 


} 


运行 效果 如 图 5-27 所 示 , 看 起 来 Fragment 的 界面 与 上 一 节 ViewPager 的 效果 没什么 不 同 。 
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/ 
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图 5-27 动态 注册 的 Fragment 效果 


下 面 来 看 Fragment 的 生命 周期 。 人 惯例 先 输出 代码 加 上 生命 周期 的 日 
册 的 运行 日 志 。 下 面 是 打开 页 面 时 的 日 志 信息 : 


12:28:28.074: D/FragmentDynamicActivity(5809): onCreate 
12:28:28.074: D/FragmentDynamicActivity(5809): onStart 
12:28:28.074: D/FragmentDynamicActivity(5809): onResume 
12:28:28.086: D/DynamicFragment(5809): onAttach position=0 
12:28:28.086: D/DynamicFragment(5809): onCreate position=0 
12:28:28.114: D/DynamicFragment(5809): onCreateView position=0 
12:28:28.114: D/DynamicFragment(5809): onActivityCreated position=0 
12:28:28.114: D/DynamicFragment(5809): onStart position=0 
12:28:28.114: D/DynamicFragment(5809): onResume position=0 


可 


Ee 


然后 观察 动态 注 
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12:28:28.114: 
12:28:28.114: 
12:28:28.146: 
12:28:28.146: 
12:28:28.146: 


下 面 是 退出 页 面 时 的 日 志 信息 : 
12:28:57.994: 


D/DynamicFragment(5809): 
D/DynamicFragment(5809): 
D/DynamicFragment(5809): 
D/DynamicFragment(5809): 
D/DynamicFragment(5809): 


D/DynamicFragment(5809): 


onAttach position=0 
onCreate position=0 
onCreateView position=1 
onStart position=1 
onResume position=1 


onPause position=0 


12:28:57.994: 
12:28:57.994: 
12:28:58.402: 
12:28:58.402: 
12:28:58.402: 


D/DynamicFragment(5809): onPause position=1 
D/FragmentDynamicActivity(5809): onPause 
D/DynamicFragment(5809): onStop position=0 
D/DynamicFragment(5809): onStop position=1 
D/FragmentDynamicActivity(5809): onStop 


12:28:58.402: 
12:28:58.402: 
12:28:58.402: 
12:28:58.402: 
12:28:58.402: 
12:28:58.402: 


D/DynamicFragment(5809): 
D/DynamicFragment(5809): 
D/DynamicFragment(5809): 
D/DynamicFragment(5809): 
D/DynamicFragment(5809): 
D/DynamicFragment(5809): 


onDestroyView position=0 
onDestroy position=0 
onDetach position=0 
onDestroy View position=1 
onDestroy position=1 
onDetach position=1 


12:28:58.402: D/FragmentDynamicActivity(5809): onDestroy 


日 志 搜 集 完毕 ， 接 下 来 分 析 一 下 这 其 中 的 奥妙 。 笔 者 总 结 了 一 下 ， 主 要 有 以 下 三 点 : 

(1) 动态 注册 时 ，Fragment 的 onCreate 操作 在 Activity 之 后 ， 其 余 操 作 的 先后 顺序 与 静 
态 注册 时 保持 一 致 。 

(2) 注意 onActivityCreated 方法 。 无 论 是 静态 注册 还 是 动态 注册 ， 该 方法 都 在 Activity 





的 onCreate 操作 之 后 。 可 见 该 方法 在 页 面 创建 之 后 才 调 用 。 
(3) 最 重要 的 一 点 ， 进 入 第 一 个 Fragment， 实 际 只 加 载 了 第 一 页 和 第 二 页 ， 并 没有 加 载 


全 部 Fragment。 这 正 是 Fragment 的 优越 之 处 ， 无 论 当 前 位 于 哪 一 页 ， 系 统 都 只 会 加 载 当前 页 
及 相 邻 的 前 后 两 页 ， 总 共 加 载 不 超过 三 页 。 一 旦 发 生 页 面 切换 ， 相 邻 页 面 就 被 加 载 ， 非 相 邻 页 
面 就 被 回收 。 这 么 做 的 好 处 是 节省 了 宝贵 的 系统 资源 , 只 有 用 户 正在 浏览 与 将 要 浏览 的 Fragment 
才 会 加 载 ， 避 免 所 有 Fragment 一 起 加 载 造 成 资源 浪费 ， 这 正 是 普通 ViewPager 的 缺点 。 


5.4.3 ”改进 的 启动 引导 页 


接 下 来 把 Fragment 用 于 实战 ， 为 “5.3.3 简单 的 启动 引导 页 ”做 个 改进 。 与 之 前 相 比 ， 布 
局 文件 不 变 ， 改 动 的 都 是 代码 。 下 面 是 碎片 适配器 的 代码 : 
public class LaunchImproveAdapter extends FragmentStatePagerAdapter { 
private int[] mImageArray; / 声明 一 个 图 片 数 组 





/ 碎片 页 适配器 的 构造 函数 ， 传 入 碎片 管理 器 与 图 片 数 组 
public LaunchImproveAdapter(FragmentManager fm, int[] imageArray) { 
super(fm); 
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mImageArray = imageArray; 
} 


1/ 获取 碎片 Fragment 的 个 数 
public int getCount() { 
return mImageArray.length; 


/ 获取 指定 位 置 的 碎片 Fragment 
public Fragment getItem(int position) { 
return LaunchFragment.newInstance(position, mImageArray[position]); 
) 
} 


下 面 是 每 个 启动 页 的 Fragment 代码 : 


public class LaunchFragment extends Fragment { 
protected View mView;”// 声明 一 个 视图 对 象 
protected Context mContext; // 声明 一 个 上 下 文 对 象 
private int mPosition; / 位 置 序号 
private int mImageId; / 图 片 的 资源 编号 
private int mCount = 4; // 引导 页 的 数量 


/ 获取 该 碎片 的 一 个 实例 

public static LaunchFragment newInstance(int position, int image_id) { 
LaunchFragment fragment =new LaunchFragment(); / 创建 该 碎片 的 一 个 实例 
Bundle bundle = new Bundle0); / 创建 一 个 新 包 囊 
bundle.putInt("position", position); / 往 包 庄 存 入 位 置 序号 
bundle.putInt("image_id", image id); / 往 包 衷 存 入 图 片 的 资源 编号 
fragment.setArguments(bundle); / 把 包 庄 塞 给 碎片 
return fragment; / 返回 碎片 实例 


/ 创建 碎片 视图 
public View onCreate View(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 
mContext = getActivity(); / 获取 活动 页 面 的 上 下 文 
让 (getArguments() != null) { // 如 果 碎 片 携带 有 包 里 ， 则 打开 包 庄 获取 参数 信息 
mPosition = getArguments().getInt("position", 0); 
mImageld = getArguments().getInt("image_id", 0); 
} 
/ 根据 布局 文件 item_launch.xml 生成 视图 对 象 
mView = inflaterinflate(R.layoutitem_launch, container, false); 
ImageView iv_launch = mView.findViewById(R.id.iv_launch); 
RadioGroup rg_indicate = mView.findViewById(R.id.rg_indicate); 
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Button btn_start= mView.findViewById(R.id.btn_starb; 
/ 设置 引导 页 的 全 屏 图 片 
iv_launch.setImageResource(mImageld); 
/ 每 张 图 片 都 分 配 一 个 对 应 的 单 选 按 钮 RadioButton 
for (intj= 0;j <mCount; jH+) { 
RadioButton radio = new RadioButton(mContext); 
radio.setLayoutParams(new LayoutParams(LayoutParams.WRAP_CONTENT, 
LayoutParams.WRAP_ CONTENT)); 
radio.setButtonDrawable(R.drawable.launch guide); 
radio.setPadding(10, 10, 10, 10); 
/ 把 单 选 按钮 添加 到 底部 指示 器 的 单 选 组 
rg_indicate.addView(radio); 
b 
/ 当前 位 置 的 单 选 按 钮 要 高 亮 显 示 ， 比 如 第 二 个 引导 页 就 高 亮 第 二 个 单 选 按钮 
((RadioButton) rg_indicate.getChildAt(mPosition)).setChecked(true); 
// 如 果 是 最 后 一 个 引导 页 ， 则 显示 入 口 按钮 ， 以 便 用 户 点 击 按钮 进入 首页 
if (mPosition 一 mCount- 1) { 
btn_start.setVisibility(View.VISIBLE); 
btn_start.setOnClickListener(new OnClickListenerO { 
@Override 
public void onClick(View v) { 
Toast.makeText(mContext, "欢迎 您 开启 美好 生活 "， 
Toast.LENGTH_SHORT).show(); 
} 
D); 
l: 
retum mView; / 返回 该 碎片 的 视图 对 象 


} 


改进 后 的 引导 页 跟 之 前 差不多 ， 这 里 只 列 出 最 后 一 
页 的 效果 图 ， 如 图 5-28 所 示 。 


5.5 广播 Broadcast 基础 


本 节 介 绍 为 何 使 用 广播 Broadcast 和 如 何 使 用 广播 ， 
包括 发 送 临 时 广播 、 注 册 接 收 器 BroadcastReceiver 接收 
临时 广播 、 通 过 定时 器 设置 定时 广播 、 在 
AndroidManifest.xml 中 注册 接收 器 接收 系统 发 出 的 定时 
广播 。 图 5-28 ”Fragment 改造 后 的 启动 引导 页 
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5.5.1 发 送 /接收 临时 广播 


页 面 与 页 面 之 间 传 递 和 传 回 消息 可 使 用 Intent。 页 面向 适配器 传递 消息 可 使 用 适配器 的 构 
造 函 数 ; 适配器 向 页 面 传 回 消息 有 点 麻烦 ， 在 “5.2.3 网 格 视 图 GridView” 的 商品 频道 改造 时 
就 遇 到 了 ， 当 时 是 在 适配器 构造 函数 中 传 入 回调 接口 ,适配器 调用 回调 接口 的 方法 ， 从 而 实现 
把 消息 传 回 页 面 。 页 面向 碎片 传递 消息 可 在 碎片 适配器 中 为 碎片 对 象 设置 情景 参数 〈 调 用 
setArguments 方法 ) 。 碎 片 如 何 把 消息 传 回 页 面 呢 ? 这 个 问题 看 起 来 很 高 深 ， 其 实 至 少 有 两 种 

(1) Fragment 提供 了 onAttach 方法 ，onAttach 方法 指定 了 结合 的 Activity 对 象 。 同 样 定 
义 一 个 回调 接口 ， 把 Activity 对 象 强 制 转换 为 回调 接口 就 可 以 在 碎片 中 调用 页 面 方法 。 这 种 方 
式 不 是 本 节 的 重点 ， 有 兴趣 的 读者 可 以 自行 钻研 。 

(2) 人 人 都 想 成 为 武林 高 手 ， 捷 径 之 一 就 是 寻找 武功 秘笈 。 同 样 是 武术 教材 ， 清 风 剑 法 
练 十 年 还 不 如 九 阴 真 经 练 一 年 。Android 隐藏 着 不 少 武林 大 法 ， 每 当 你 按照 常规 思路 难以 解决 
问题 时 ， 往 往 用 一 个 大 法 就 可 以 迎刃而解 。“5.2 列表 类 视图 ”在 处 理 ListView 与 GridView 
的 分 隔 线 时 便 用 到 了 padding 大 法 。 现 在 适配器 向 页 面 传 回 消息 有 一 个 Broadcast 大 法 ， 无 论 
对 方 在 何 处 ， 只 要 用 Broadcast 大 法 吼 一 吼 ， 对 方 立 刻 能 够 听 到 ， 岂 不 妙 哉 ! 


广播 (Broadcast) 用 于 Android 组 件 之 间 的 灵活 通信 ， 与 Activity 的 区 别 在 于 : 


(1) Activity 只 能 一 对 一 通信 ; Broadcast 可 以 一 对 多 ， 一 人 发 送 广播 ， 多 人 接收 处 理 。 

(2) 对 于 发 送 者 来 说 , 广播 不 需要 考虑 接收 者 有 没有 在 工作 ,接收 者 在 工作 就 接收 广播 ， 
不 在 工作 就 丢弃 广播 。 

(3) 对 于 接收 者 来 说 , 会 收 到 各 式 各 样 的 广播 , 所 以 接收 者 要 自行 过 滤 符 合 条 件 的 广播 ， 
才能 进行 解 包 处 理 。 

与 广播 有 关 的 方法 主要 有 以 下 3 个 。 

e@ ”sendBroadcast: 发 送 广播 。 


。 registerReceiver: 注册 接收 器 ， 一 般 在 onStart 或 onResume 方法 中 注册 。 
eunregisterReceiver: 注销 接收 器 ， 一 般 在 onStop 或 onPause 方法 中 注销 。 


如 果 广 播 是 在 应 用 内 使 用 ， 不 需要 跨 进程 ， 建 议 使 用 LocalBroadcastManager 下 的 
registerReceiver 与 unregisterReceiver 方法 ， 因 为 这 样 不 但 更 有 效率 (不 需要 跨 进程 通信 ) ， 而 
且 不 用 考虑 广播 开放 造成 的 安全 问题 〈 如 果 其 他 应 用 也 能 收 到 广播 ) 。 

为 说 明 广 播 的 工作 流程 ， 下 面 对 其 进行 具体 的 演示 。 现在 Fragment 内 有 一 个 Spinner 下 拉 
框 ， 可 选择 背景 颜色 ， 一 旦 选中 某 个 背景 色 ， 整 个 活动 页 面 的 背景 色 就 换 成 新 颜色 。Fragment 
内 部 发 现 选 中 颜色 后 ， 要 发 送 一 个 背景 色 变更 的 广播 ， 代 码 如 下 : 

/ 声明 一 个 广播 事件 的 标识 串 

public final static String EVENT = "com.example.senior.fragment.BroadcastFragment"; 
/ 声明 一 个 颜色 名 称 数组 

private String[] mColorNameArray = {" 红 色 ", "黄色 ", "绿色 ", "青色 ", " 蓝 色 "}:; 

// 声明 一 个 颜色 类 型 数组 
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private int[] mColorldArray = {Color.RED,Color.YELLOW,Color.GREEN,Color.CYAN,Color.BLUE;}; 
// 定义 一 个 与 下 拉 框 配套 的 颜色 选择 监听 器 
class ColorSelectedListener implements OnItemSelectedListener { 
public void onltemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
/ 创建 一 个 广播 事件 的 意图 
Intent intent = new Intent(BroadcastFragment.EVENT); 
intent.putExtra("seq", arg2); 
intent.putExtra("color", mColorldArray[arg2]); 
// 通过 本 地 的 广播 管理 器 来 发 送 广 播 
LocalBroadcastManager.getInstance(mContext).sendBroadcast(intent); 
} 


public void onNothingSelected(AdapterView<?> arg0) {} 
| 


同时 ，Activity 代码 要 实现 背景 色 变更 的 广播 接收 器 。 一 旦 接收 到 背景 色 变更 的 广播 ， 就 
立即 修改 页 面 为 最 新 的 背景 色 ， 示 例 代码 如 下 : 


public void onStart() { 

super.onStart(); 

/ 创建 一 个 背景 色 变更 的 广播 接收 器 

bgChangeReceiver = new BgChangeReceiver(); 

/ 创建 一 个 意图 过 滤器 ， 只 处 理 指定 事件 来 源 的 广播 

IntentFilter filter = new IntentFilter(BroadcastFragment.EVENT); 

/ 注册 广播 接收 器 ， 注 册 之 后 才能 正常 接收 广播 

LocalBroadcastManager.getInstance(this).registerReceiver(bgChangeReceiver, filter); 
) 


public void onStop() { 
super.onStop(); 


/ 注销 广播 接收 器 ， 注 销 之 后 就 不 再 接收 广播 
LocalBroadcastManager.getInstance(this).unregisterReceiver(bgChangeReceiver); 


) 


/ 声明 一 个 背景 色 变更 的 广播 接收 器 
private BgChangeReceiver bgChangeReceiver; 
/ 定义 一 个 广播 接收 器 ， 用 于 处 理 背景 色 变更 事件 


Private class BgChangeReceiver extends BroadcastReceiver { 


/ 一 旦 接收 到 背景 色 变更 的 广播 ， 马 上 触发 接收 器 的 onReceive 方法 
public void onReceive(Context context, Intent intent) { 
if (intent !{= nulD) { 
/ 从 广播 消息 中 取出 最 新 的 颜色 
int color = intent.getIntExtra("color", Color. WHITE); 
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/ 把 页 面 背景 设置 为 广播 发 来 的 颜色 
ll_brd_temp.setBackgroundColor(color); 


) 
广播 效果 如 图 5-29 所 示 。 在 Fragment 内 部 选择 青色 ， 整 个 页 面 的 背景 色 都 变 了 。 


Mate10 小 米 6 OPPOF 
切换 背景 青色 本 





小 米 MI6 全 网 通 版 6GB+128GB 这 白色 
图 5-29 ”Fragment 发 送 广播 ，Activity 接收 广播 
5.5.2 ”定时 器 AlarmManager 


AlarmManager 是 Android 提供 的 一 个 全 局 定时 器 ， 利 用 系统 闹钟 定时 发 送 广播 。 这 样 做 
的 好 处 是 : 如 果 App 提前 注册 闹钟 的 广播 接收 器 ， 即 使 App 退出 了 ， 只 要 定时 到 达 ，App 就 
会 被 唤醒 响应 广播 事件 。 是 不 是 很 神奇 ? App 都 不 在 了 还 能 自动 响应 ? 没 错 ， 就 是 这 样 ， 要 不 
然 Broadcast 怎么 对 得 起 大 法 的 名 号 。 

下 面 来 看 这 种 奇妙 的 事情 是 如 何 实现 的 ,首先 在 页 面 代码 中 通过 AlarmManager 设置 闹钟 ， 
具体 代码 如 下 : 
public void onClick(View v) { 

if (v.getId() 一 R.id.btn_alarm) { 
// 创建 一 个 广播 事件 的 意图 
Intent intent = new Intent(ALARM_ EVENT); 
// 创建 一 个 用 于 广播 的 延迟 意图 
PendingIntent pIntent = PendingIntent.getBroadcast(this, 0, intent, 

PendingIntent.FLAG_ UPDATE CURRENT); 

// 从 系统 服务 中 获取 闵 钟 管理 器 
AlarmManager alarmMegr = (Alarm Manager) getSystemService(ALARM SERVICE); 
Calendar calendar = Calendar.getInstance(); 
calendar.setTimeInMillis(System.currentTimeMillis()); 
/ 给 当前 时 间 加 上 若干 秒 
calendar.add(Calendar.SECOND, mDelay); 
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// 开始 设 定 闹钟 ， 延 迟 若干 秒 后， 携带 延迟 意图 发 送 闹 钟 广播 
alarmMgrset(AlarmManagerRTC_WAKEUP, calendar.getTimeInMillis(), pIntent); 
mDesc = DateUtil.getNowTime() +"” 设置 闹钟 "; 


tv_alarm.setText(mDesc); 


上 


然后 在 页 面 代码 中 定义 一 个 广播 接收 器 AlarmReceiver， 示 例 代码 如 下 : 


/ 声明 一 个 广播 事件 的 标识 串 


private String ALARM_ EVENT = "com.example.senior.AlarmActivity.AlarmReceiver"; 
private static String mDesc =""; / 亲 钟 时 间 到 达 的 描述 
private static boolean isArrived = false; / 六 钟 时 间 是 否 到 达 


// 定义 一 个 闹钟 广播 的 接收 器 


public static class AlarmReceiver extends BroadcastReceiver { 


/ 一 旦 接收 到 闹钟 时 间 到 达 的 广播 ， 马 上 触发 接收 器 的 onReceive 方法 


public void onReceive(Context context Intent intent) { 


if (intent {= null) { 


Log.d(TAG, "AlarmReceiver onReceive"); 
if (tv_alarm != null && !isArrived) { 


isArrived = true; 


mDesc = String.format("%s\n%s 闲 钟 时 间 到 达 ", mDesc, DateUtil.getNowTime()); 
tv_alarm.setText(mDesc); 


) 


接着 打开 AndroidManifestxml， 在 application 节点 下 增加 广播 接收 器 的 声明 (注意 ， 凡 是 
在 AndroidManifestxml 中 声明 的 ， 就 叫 静态 注册 ;在 代码 中 声明 叫 动态 注册 ) : 


<receiver android:name=".AlarmActivity$AlarmReceiver" > 


这 上 





<intent-filter> 


<action android:name="com.example.senior.AlarmActivity.AlarmReceiver" /> 


</intent-filter> 


</receiver> 


有 插播 一 下 Android 9.0 对 广播 的 好 

















E 大 调整 ， 为 提高 安 卓 系统 的 安全 性 ， 从 9.0 开始 ， 


系统 全 面 禁 止 刚 才 静 态 注册 的 广播 ， 凡 是 静态 广播 在 9.0 系统 中 都 不 再 有 效 ， 因 此 为 了 适 配 
Android 9.0， 静 态 注册 的 广播 都 要 换 成 在 代码 里 声明 的 动态 广播 , 具体 的 适 配 代 码 相 见 本 书 附 
录 源 码 senior 模块 的 AlarmActivity.java。 

最 后 的 演示 界面 如 图 5-30 和 图 5-31 所 示 。 其 中 ， 图 5-30 是 开始 设置 闹钟 时 的 界面 ， 图 
5-31 是 收 到 闹钟 广播 时 的 界面 。 
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这 里 的 定时 器 能 够 完美 实现 广播 功能 , 就 是 AlarmManager 与 PendingIntent 相 互 配 合 的 成 果 。 
Senior Senior 


闹钟 延迟 5 秒 闹钟 延迟 5 秒 


设置 闹钟 设置 闹钟 


16:31:49 设置 闹钟 16:31:49 设置 闹钟 
16:31:54 闲 钟 时 间 到 达 





图 5-30 开始 设置 闹钟 图 5-31 收 到 闹钟 广播 


PendingIntent 的 意思 是 延迟 的 意图 ， 只 要 不 是 立即 传递 的 消息 ， 都 要 用 PendingIntent。 与 
之 对 应 的 , 平常 开发 者 通过 Activity 与 Broadcast 传递 消息 都 要 求 立 即 处 理 ， 所 以 用 Intent。 闹 
钟 存在 延迟 ， 所 以 必须 用 PendingIntent，PendingIntent 调用 了 getBroadcast 方法 ， 表 示 这 次 携 
带 的 消息 用 于 发 送 广 播 。 

另外 注意 ，AlarmManager 的 set 方法 用 于 设置 一 次 性 定时 器 , 该 方法 的 第 一 个 参数 表示 定 
时 器 类 型 (一 般 是 AlarmManagerRTC_WAKEUP， 表 示 定 时 器 即使 在 睡眠 状态 下 也 会 启用 ) ， 
第 二 个 参数 表示 任务 的 执行 时 间 ， 第 三 个 参数 表示 携带 消息 的 延迟 任务 〈getBroadcast 返回 的 
PendingIntent 对 象 ) 。 


5.6 ”实战 项 目 : 万 年 历 


手机 自 诞生 之 初 ， 就 具备 两 项 基本 功能 ， 一 个 是 通话 功能 ， 另 一 个 是 时 间 功 能 。 最 简单 的 
时 间 功 能 仅 能 查看 当前 的 年 月 日 、 时 分 秒 ， 若 要 拓展 它 的 功能 ， 则 可 由 日 历 变 月 历 ， 在 年 月 日 
之 外 补充 星期 几 ， 再 添加 节假日 描述 。 进 一 步 升 级 扩展 ， 由 月 历 变 年 历 ， 分 别 按 公历 与 农历 纪 
年 ， 便 成 了 万 年 历 。 本 节 就 来 论述 如 何 运 用 已 学 的 知识 ， 构 建 一 部 实用 的 万 年 历 。 


5.6.1 设计 思路 


手机 上 的 日 历 一 般 是 一 个 月 一 个 页 面 , 一 年 十 二 个 月 就 是 十 二 个 页 面 。 日历 展示 的 信息 有 
公历 日 ， 有 农历 日 ， 还 有 常见 节假日 ， 以 及 二 十 四 节气 。 大 家 对 日 历 都 很 熟悉 ， 所 以 也 不 嘱 嗪 
了 ， 直 接 上 个 万 年 历 项 目的 效果 图 。 如 图 5-32 所 示 ， 这 是 2018 年 3 月 份 的 日 历 页 ， 如 图 5-33 
所 示 ， 这 是 2018 年 10 月 份 的 日 历 页 。 

首先 数 一 数 万 年 历 项 目 用 到 了 本 章 的 哪些 新 知识 ， 光 看 效果 图 大 概 会 发 现下 面 几 个 : 


网 格 视图 GridView: 每 月 的 日 期 项 采用 了 GridView， 每 行 七 列 。 

基本 适配器 BaseAdapter: 网 格 项 要 展示 公历 日 、 农 历 日 、 节 日 与 节气 ， 需 要 适配器 配合 。 
翻 页 视图 ViewPager: 一 年 十 二 个 月 ， 支 持 左右 滑 动 ， 用 到 了 ViewPager。 

碎片 Fragment: 十 二 个 月 对 应 十 二 个 页 面 ， 每 个 页 面 都 是 一 个 Fragment。 

碎片 适配器 FragmentStatePagerAdapter: 把 十 二 个 Fragment 组 装 到 ViewPager 中 。 
选项 卡 标题 栏 PagerTabStrip: 日 历 上 方 每 个 月 的 月 份 标题 ， 对 应 的 是 PagerTabStrip。 
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SenNIor SenloOr 
2018 年 - 
四 月 九 月 十 月 十 一 月 
周 六 | 周 日 周一 | 周二 | 周三 | 周 四 | 周 五 | 周 六 | 周 日 
| 26 27 28 1 涵 3 4 1 2 3 4 5 6 了 
十 十 二 | 十 三 | 十 四 | 元 离 节 | 十 六 | 十 七 国庆 节 | 廿 三 | 蔷 四 | 甘 五 | 廿 六 | 甘 七 | 甘 八 
5 6 8 9 10 9 8 9 10 11 2 13 14 
| 十 八 | 惊 鳃 | 廿 十 | 妇女 节 | 廿 二 | 廿 三 | 甘 四 寒露 | 九 月 双 十 节 | 初 三 | 初 四 | 初 五 | 初 六 
| 12 13 14 轩 内 16 17 18 15 16 17 18 19 20 21 
植树 节 | 廿 六 | 革 七 " 日 甘 九 | = 月 | 初 二 初 七 | 初 八 重阳 节 | 初 十 | 十 一 | 十 二 | 十 三 
20 | 21 22 | 23 | 24 | 25 2|123|24|25|26|27 28 
初 四 | 春分 | 初 六 | 初 七 | 初 八 | 初 九 十 四 | 十 五 | 霜降 | 十 七 | 十 八 | 十 九 | 廿 十 
| 26 27 28 29 30 31 1 29 30 31 是 2 3 4 
初 十 | 十 一 | 十 二 | 十 三 | 十 四 | 十 五 | 轧 人 节 甘 一 | 廿 二 /万圣节 | 廿 四 | 廿 五 | 廿 六 | 廿 七 
图 5-32 2018 年 3 月 的 日 历 页 图 5-33 2018 年 10 月 的 日 历 页 


上 面 的 这 些 控 件 实际 是 环 环 相 扣 的 ， 整 个 日 历 拥 有 一 个 翻 页 视图 ViewPager 和 一 个 
PagerTabStrip， 然 后 ViewPager 通过 FragmentStatePagerAdapter 组 装 进 十 二 个 碎片 Fragment， 
每 个 Fragment 页 对 应 一 个 月 份 。 接 着 每 个 Fragment 页 内 部 都 存在 一 个 网 格 视图 GridView, 单 
个 GridView 通过 BaseAdapter 组 装 了 几 十 个 文本 视图 TextView, 而 TextView 个 体 又 对 应 具体 
的 某 个 日 期 。 这 里 面 的 层级 关系 概括 起 来 便 是 : ViewPager 一 FragmentStatePagerAdapter 一 
Fragment 一 GridView 一 BaseAdapter 一 TextView, 理 清 了 控件 之 间 的 依赖 与 包含 关系 , 有 助 于 接 


下 来 的 编码 工作 。 
5.6.2 ”小 知识 : 月 份 选 择 器 MonthPicker 


万 年 历 采取 ViewPager 展示 的 话 , 同年 的 不 同月 份 可 以 
通过 左右 滑动 来 切换 , 那么 不 同年 份 的 指定 月 份 又 该 如 何 跳 
转 ? Android 提供 了 日 期 选择 器 DatePicker 和 时 间 选 择 器 
TimePicker， 却 没有 提供 月 份 选择 器 MonthPicker， 一 时 之 
间 叫 人 不 知 如 何 是 好 。 可 是 为 啥 支付 宝 的 账单 查询 支持 月 份 
呢 ? 就 像 图 5-34 所 示 的 支付 宝 查询 账单 页 面 ， 分 明 可 以 单 
独 选择 年 月 。 

看 上 去 ， 支 付 宝 的 年 月 控件 跟 系统 自 带 的 日 期 选择 器 
DatePicker 很 相像 ， 区 别 在 于 去 掉 了 右 侧 的 日 子 列表 。 二 者 
之 间 如 此 相似 , 这 可 不 是 偶然 撞 衫 , 而 是 它们 本 来 系 出 一 源 。 
只 要 把 日 期 选择 器 稍 加 修改 ， 想 办 法 隐藏 右边 多 余 的 日 子 
列 , 即 可 实现 移花接木 的 效果 。 下 面 是 将 日 期 选择 器 算 改 之 
后 变 成 月 份 选择 器 的 代码 示例 : 








所 。 选择 时 间 完成 
按 月 选择 二 
2018-01 
2017 2 
2018 a 





图 5-34 支付 宝 查 询 账单 页 面 


/ 由 日 期 选择 器 派生 出 月 份 选择 器 
public class MonthPicker extends DatePicker { 
public MonthPicker(Context context, AttributeSet attrs) { 
super(context, attrs); 
/ 获取 年 月 日 的 下 拉 列 表 项 
ViewGroup vg = ((ViewGroup) ((ViewGroup) getChildAt(0)).getChildAt(0)); 
if (vg.getChildCount() — 3) { 
// 有 的 机 型 显示 格式 为 “年 月 日 ” 此 时 隐藏 第 三 个 控件 
Vg.getChildAt(2).setVisibility(View.GONE); 
} else if (vg.getChildCount() =— 5) { 
// 有 的 机 型 显示 格式 为 “年 | 月 | 日 ”， 此 时 隐藏 第 四 个 和 第 五 个 控件 ( 即 “| 日 ”) 
vg.getChildAt(3).setVisibility(View.GONE); 
vg.getChildAt(4).setVisibility(View.GONE); 


} 

由 于 日 期 选择 器 有 日 历 和 下 拉 框 两 种 展示 形式 ， 以 上 的 月 份 选择 器 代码 只 对 下 拉 框 生效 ， 
因此 布局 文件 添加 月 份 选择 器 之 时 , 要 特别 注意 添加 属性 “android:datePickerMode="spinner"”， 
表示 该 控件 采取 下 拉 列 表 显示 。 月 份 选择 器 在 布局 文件 中 的 定义 例子 如 下 所 示 : 

<com.example.senior widget.MonthPicker 
android:id="(@+id/mp_month" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:calendarViewShown="false" 
android:datePickerMode="spinner" 
android:gravity="center" 





android:spinnersShown="true" /> 
这 下 大 功 告 成 ， 重 新 包装 后 的 月 份 选 择 器 癸 然 又 是 日 期 时 间 控 件 家 族 的 一 员 ， 不 但 继承 了 日 
期 选择 器 的 所 有 方法 ， 而 且 控 件 界面 与 支付 宝 的 不 差 毫 厘 。 月 份 选择 器 的 真 机 界面 效果 如 图 5-35 
和 图 5-36 所 示 ， 其 中 图 5-35 的 手机 显示 格式 为 “年 月 ”， 图 5-36 的 手机 显示 格式 为 “年 | 月 ”。 


请 选择 月 份 


2018s 3 有 


5n1a 





确定 





图 5-35 格式 为 “年 月 ”的 月 份 选择 器 图 5-36 ”格式 为 “年 | 月 ”的 月 份 选择 器 
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5.6.3 ”代码 示例 


本 实战 项 目 用 到 的 控件 编码 大 多 写 在 独立 的 代码 文件 中 , 为 方便 管理 , 可 将 这 些 代码 文件 
分 门 别 类 。 于 是 接 下 来 的 编码 过 程 多 出 一 步 ， 变 为 五 步 了 : 
EI0) 设计 代码 架构 。 初 步 归 类 后 的 package 包 分 为 以 下 5 部 分 。 


com.example.calendar.activity: 存放 Acitivity 页 面 的 代码 。 
com.example.calendar.adapter: 存放 适配器 的 代码 ， 包 括 基本 适配器 和 碎片 适配器 。 
com.example.calendar.fragment: 存放 每 个 月 份 的 碎片 代码 。 
com.example.calendar.util: 存放 工具 类 的 代码 。 

com.example.calendar.widget: 存放 定制 化 修改 后 的 月 份 选择 器 代码 。 


CT02 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 万 年 历 页 面 的 代码 文件 取 名 
CalendarActivity.java， 对 应 的 布局 文件 是 activity_calendar.xml。 另 外 还 有 适配器 与 碎片 的 代码 及 其 
布局 文件 ， 读 者 可 自行 构思 。 

03 在 AndroidManifest.xml 中 注册 万 年 历 页 面 的 acitivity 节点 ， 注 册 代码 如 下 所 示 : 











<activity android:name=".activity.CalendarActivity" /> 
(304 在 res/layout 目录 下 编写 布局 文件 。 
C05 进行 java 代码 开发 ， 包 括 页 面 、 适 配器 、 碎 片 等 的 编码 。 与 日 历 有 关 的 公历 、 农 历 、 
二 十 四 节气 计算 相关 逻辑 ， 可 参考 本 书 附带 源码 senior 模块 的 CalendarGridAdapterjava。 


现在 除了 左右 滑动 切换 月 份 之 外 , 还 能 通过 月 份 选择 器 直接 跳 到 其 他 年 份 , 可 谓 是 名 副 其 
实 的 万 年 历 了 。 壁 如 点 击 页 面 上 方 的 “2018 年 ”文字 ， 则 下 方 弹 出 月 份 选择 器 如 图 5-37 所 示 ; 
上 下 滑动 到 指定 的 年 月 如 2018 年 10 月 ， 然 后 点 击 “ 确 定 ” 按 钮 ， 此 时 日 历 页 自动 切 到 如 图 
5-38 所 示 的 该 月 份 网 格 月 历 。 





senior 
SenIOr 








年 月 1 二 3 4 5 和 
2018 10 国庆 节 | 甘 三 | 廿 四 | 甘 五 | 廿 六 | 甘 七 | 甘 八 


2019 11 8 ,9 10 11 13 | 14 
寒露 九 月 双 十 节 | 初 三 | 初 四 | 初 五 | 初 六 





确定 19 


15|16|17|18 20 
初 七 | 初 八 重阳 节 | 初 十 | 十 一 | 十 二 | 十 三 

















5-37 重新 选择 万 年 历 的 年 月 图 5-38 选择 年 月 后 的 月 历 页 面 
下 面 简单 介绍 一 下 本 书 附带 源码 senior 模块 中 ， 与 万 年 历 有 关 的 主要 代码 之 间 的 关系 : 
(1) CalendarActivityjava: 这 是 万 年 历 的 主页 面 入 口 ， 内 含 展 示 月 历 的 翻 页 视图 
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ViewPager、 展 示 月 份 标题 的 选项 卡 标题 栏 PagerTabStrip， 以 及 平时 隐藏 着 、 切 换 年 月 时 才 显 
示 的 月 份 选择 器 MonthPicker。 

(2) CalendarPagerAdapter.java: 包括 全 部 月 历 的 ViewPager 一 共有 12 页 ， 它 与 具体 月 份 
页 之 间 通 过 CalendarPagerAdapter 关联 起 来 。 

(3) CalendarFragment.java: 这 是 某 个 月 的 月 历 ， 以 碎片 Fragment 的 形式 加 入 到 翻 页 适 
配器 中 。 内 含 一 个 GridView 网 格 视图 ， 网 格 的 每 个 单元 就 是 一 个 具体 的 日 期 。 

(4) CalendarGridAdapter.java: 网 格 一 行 展示 7 天 〈 即 一 星期 ， 五 行 便 能 容纳 当月 的 
所 有 日 子 。 该 月 与 其 下 的 日 期 之 间 通 过 CalendarGridAdapter 关联 起 来 ， 具 体 的 日 子 可 使 用 一 
个 文本 视图 TextView 来 表达 。 


5.7 ”实战 项 目 : 日 程 表 


本 章 介绍 了 好 几 个 高 级 控件 ， 如 此 一 来 ， 实 战 项 目的 功能 也 变 得 较为 复杂 了 。 可 是 上 一 
节 的 万 年 历 项 目 覆盖 的 知识 点 有 点 少 ， 要 想 全 面 、 深 入 地 复习 本 章 的 大 部 分 知识 点 ， 还 要 重新 
设计 一 个 日 程 表 项 目 。 这 样 通过 实战 项 目的 练习 ， 可 以 更 好 地 掌握 高 级 控件 的 用 法 。 


5.7.1 设计 思路 


日 程 表 不 但 支持 基本 的 日 历 信息 展示 ， 而 且 支持 用 户 设 定 每 天 的 日 程 安排 ， 还 支持 日 程 
提醒 时 间 。 如 此 一 来 , 日 程 表 项 目 分 成 两 个 页 面 , 一 个 是 类 似 日 历 的 主页 面 , 另 一 个 是 查看 日 
程 详情 的 页 面 。 图 5-39 所 示 为 日 程 表 的 主页 面 ， 因 为 要 展示 每 日 的 日 程 摘要 ， 所 以 每 天 占用 

- 行 、 一 个 页 面 展 示 七 行 ( 一 周 的 日 历 ) 。 点 击 每 行 日 历 进入 日 程 安排 页 面 ， 如 图 5-40 所 示 。 
当天 无 安排 就 新 增 日 程 ， 已 有 安排 就 查看 日 程 详情 。 


后 退 日 程 安排 保存 
当前 日 期 ，2018 年 10 月 4 日 农历 八 月 廿 五 
星期 四 


日 程 时 间 :09:30 
提醒 间隔: 提前 半 小 时 a 
日 程 题 去 海边 玩 
星期 三 10 月 3 日 农历 八 月 家 四 
今 儿 无 日 程 安 推 、，; 日 程 内 容 
相 
星期 四 10 月 4 日 农历 八 月 廿 五 捡 贝壳 
今日 斩 元 日 和 安排 天 区 
六 
星期 五 10 月 5 日 农历 八 月 廿 六 ， 观看 海上 日 出 
二 沐浴 海风 ， 倾 听 涛 声 


星期 六 10 月 6 日 农历 八 月 革 | 
今日 暂 无 日 程 安排 


星期 日 10 月 7 日 农历 八 月 
今日 暂 无 日 程 安 











图 5-39 日 程 表 主 页 面 图 5-40 日 程 表 详 情 页 
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有 了 效果 图 ， 再 来 看 日 程 表 项 目 用 到 的 知识 点 ， 仔 细 找 找 你 会 发 现 几 个 ? 


e@ 列表 视图 ListView: 每 页 日 历 包 含 7 天 (一 周 的 日 期 ) ,采用 了 ListView。 

基本 适配器 BaseAdapter: 列表 项 要 展示 当天 的 公历 日 、 农 历 日 、 节 日 与 节气 ， 还 要 展 

示 当 天 的 日 程 安排 标题 ， 需 要 适配器 配合 。 

翻 页 视图 ViewPager: 每 页 一 周 ， 一 年 52 周 ， 支 持 左右 滑动 ， 用 到 了 ViewPager。 

碎片 Fragment: 52 周 对 应 52 个 页 面 ， 每 个 页 面 都 是 一 个 Fragment。 

碎片 适配器 FragmentStatePagerAdapter: 把 52 个 Fragment 组 装 到 ViewPager 中 。 

选项 卡 标题 栏 PagerTabStrip: 日 历 上 方 每 周 的 周 数 标 题 对 应 PagerTabStrip。 

广播 Broadcast: 每 页 根据 当 周 的 节日 设置 背景 图 ， 如 国庆 节 所 在 周 显示 华表 背景 ， 中 

秋 节 所 在 周 显 示 圆 月 背景 ， 当 周 无 节日 显示 晴天 背景 。 由 Fragment 通知 Activity 变更 

背景 ， 上 一 节 讲 过 可 用 广播 技术 ，Fragment 发 送 广播 ，Activity 接收 广播 。 

e 时 间 选 择 对 话 框 TimePickerDialog: 设置 日 程 安排 要 选择 日 程 时 间 ， 即 时 间 选 择 对 话 
框 。 

e。 定时 器 AlarmManager: 设置 日 程 提醒 时 间 ， 一般 要 指定 提前 若干 分 钟 ， 这 个 定时 任务 
就 靠 AlarmManager。 


另外 , 还 包括 其 他 已 经 学 过 的 控件 知识 , 如 TextView、Button、EditText、Spinner、SQLite 
等 ， 没 法 一 一 列举 ， 有 待 读者 在 实战 中 继续 巩固 提高 。 
5.7.2 小 知识 : 震动 器 Vibrator 

上 一 小 节 的 日 程 提 醒 可 采用 手机 震动 的 方式 ， 会 用 到 震动 器 Vibrator， 它 的 对 象 从 系统 服 
务 VIBRATOR_SERVICE 中 获取 。 震 动 器 的 主要 方法 如 下 : 


e@ hasVibrator: 判断 设备 是 否 拥有 震动 器 。 
e@ vibrate: 震动 手机 。 可 设 定单 次 震动 的 时 长 、 多 次 震动 的 时 长 、 是 否 重复 震动 等 。 
e cancel: 取消 震动 。 
使 用 震动 器 要 在 AndroidManifest.xml 中 加 上 如 下 权限 : 
<!-- 震动 -> 
<uses-permission android:name="android.permission.VIBRATE" > 
控制 手机 震动 的 代码 很 简单 ， 下 面 短 短 几 行 就 实现 了 震动 功能 。 
/ 从 系统 服务 中 获取 震动 管理 器 
Vibrator vibrator = (Vibrator) getSystemService(Context.VIBRATOR_SERVICE); 
// 命令 震动 器 野 野 个 若干 秒 。 比 如 下 面 的 3000 表示 持续 震动 3 秒 
vibrator.vibrate(3000); 
5.7.3 ”代码 示例 


本 章 的 实战 项 目 采 用 了 大 量 适 配器 与 碎片 ， 此 时 不 仅 需要 考虑 具体 编码 ， 还 得 考虑 代码 
的 架构 。 因 为 适配器 和 碎片 都 分 布 在 单独 的 代码 文件 中 , 所 以 有 必要 用 另外 的 package 包 管 理 ， 
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这 样 不 会 跟 Activity 文件 混在 一 起 。 
于 是 ， 接 下 来 的 编码 过 程 多 出 了 一 步 ， 共 分 为 5 步 。 
CEI0) 设计 代码 架构 。 初 步 拆 分 后 的 package 包 分 为 以 下 7 部 分 。 


com.example.schedule.activity: 存放 Acitivity 页 面 的 代码 。 
com.example.schedule.adapter: 存放 适配器 的 代码 ， 包 括 基本 适配器 和 碎片 适配器 。 
com.example.schedule.bean: 存放 实体 数据 结构 的 代码 ， 如 日 程 表 的 字段 信息 。 
com.example.schedule.database: 存放 读 写 SQLite 的 数据 库 操 作 代 码 。 
com.example.schedule.fragment: 存放 碎片 代码 。 

com.example.schedule.receiver: 存放 广播 接收 器 的 代码 。 

com.example.schedule.util: 存放 工具 类 的 代码 。 





本 章 的 演示 工程 因为 加 入 了 许多 示例 代码 ， 所 以 包 名 与 相关 结构 与 上 述 package 架构 
不 尽 相同 ， 这 是 难以 避免 的 。 实 战 项 目 作为 一 个 独立 的 App,， 不 应 混入 其 他 无 关 代码 ， 
建议 读者 自己 开发 时 按照 更 清晰 的 package 架构 编码 。 


TV02 想 好 代码 文件 与 布局 文件 的 名 称 。 比 如 日 程 表 页 面 的 代码 文件 取 名 
ScheduleActivityjava， 对 应 的 布局 文件 是 activity_schedule.xml; 日 程 详情 页 面 的 代码 文件 取 名 
ScheduleDetailActivityjava， 对 应 的 布局 文件 是 activity_schedule_detail.xml; 另外 , 还 有 一 个 全 局 应 
用 的 代码 文件 MainApplication.java。 不 要 忘 了 闲 钟 广播 接收 器 的 代码 文件 AlarmReceiverjava， 还 
有 适配器 与 碎片 的 代码 及 其 布局 文件 ， 读 者 可 自行 构思 。 

ER3 在 AndroidManifestxml 中 补充 相应 配置 。 在 AndroidManifest.xml 中 补充 相应 配置 ， 
主要 有 以 下 3 点 。 


(1) 注册 2 个 页 面 的 acitivity 节点 ， 注 册 代码 如 下 : 


注意 
































<activity android:name=".activity.ScheduleActivity" /> 
<activity android:name=".activity. ScheduleDetailActivity" /> 
(2) 注册 闹钟 接收 器 的 receiver 节点 ， 注 册 代 码 如 下 : 
<receiver android:name=".receiver.AlarmReceiver" > 
<intent-filter> 
<action android:name="com.example.senior.ScheduleDetailActivity.AlarmReceiver" /> 
</intent-filter> 
</receiver> 
(3) 声明 手机 震动 的 操作 权限 ， 配 置 如 下 所 示 : 


<!-- 震动 -> 
<uses-permission android:name="android.permission. VIBRATE" /> 
B04 在 res/drawable 目录 加 入 日 程 表 用 到 的 背景 图 ， 在 res/layout 目录 下 编写 布局 文件 。 
人 ED9 进行 java 代码 开发 ， 包 括 页 面 、 适 配器 、 碎片、 广播 接收 器 等 编码 。 与 日 历 有 关 的 
公历 计算 .农历 计算 、 二 十 四 节气 计算 都 有 相应 的 开源 代码 ， 这 里 只 需 完成 控件 操作 代码 。 
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编码 完成 后 ， 日 程 表 主页 面 应 该 能 够 展示 每 日 的 日 程 安排 
文字 ， 如 图 5-41 所 示 。 
下 面 简单 介绍 一 下 本 书 附带 源码 senior 模块 中 ， 与 日 程 表 

有 关 的 主要 代码 之 间 的 关系 : 

(1) ScheduleActivity.java: 这 是 日 程 表 的 主页 面 入 口 ， 内 
含 展示 每 周 日 程 的 翻 页 视图 ViewPager、 展 示 月 份 标题 的 选项 
卡 标题 栏 PagerTabStrip 。 以 及 一 个 节日 图 片 的 广播 接收 器 ”| 轩 时 20889 BA 和 Ne 
FestivalControlReceiver， 一 旦 接收 到 Fragment 发 来 的 节日 图 片 
广播 ， 就 更 换 当 前 页 面 的 背景 图 片 。 

2) SchedulePagerAdapterjava: 一 年 包括 52 个 星期 ， 所 | 时 五 108 旨 客人 Rt 
以 ViewPager 一 共有 52 页 ， 它 与 具体 月 份 页 之 间 通 过 
SchedulePagerAdapter 关联 起 来 。 

(3) ScheduleFragment,java: 这 是 某 个 星期 的 日 程 安排 ， 6 1087 SAR 
以 碎片 Fragment 的 形式 加 入 到 翻 页 适配器 中 。 内 含 一 个 
ListView 列表 视图 ， 通 过 校 验 这 个 星期 是 否 存 在 特殊 节日 ， 来 
决定 要 将 页 面 背 景 更 换 成 哪 张 图 片 。 

(4) ScheduleListAdapter.java: 每 页 的 日 程 列表 一 共 7 行 ， 
襄 括 了 当 周 从 星期 一 到 星期 日 的 所 有 日 程 安 排 。 当 周 与 其 下 的 日 期 之 间 通 过 
ScheduleListAdapter 关联 起 来 ， 具 体 的 日 程 信息 可 使 用 一 个 文本 视图 TextView 来 表达 。 

(5) ScheduleDetailActivityjava: 点 击 列表 中 的 某 一 行 ， 即 可 跳 转 至 日 程 详情 页 面 。 在 该 
详情 页 可 以 查看 、 编 辑 当天 的 日 程 信息 ， 还 可 以 设 定 日 程 的 提醒 闹钟 。 


senior 


星期 四 10 月 4 日 农历 八 月 廿 五 
09 时 30 分 : 去 海边 玩 


星期 六 10 月 6 日 农历 八 月 地 | 
今日 暂 无 日 程 安排 





图 5-41 日 程 表 主页 面 显示 
每 日 的 日 程 安排 


5.8 小 结 


本 章 主要 介绍 了 App 开发 的 高 级 控件 相关 知识 ,包括 日 期 时 间 控件 的 用 法 (日 期 选择 器 、 
时 间 选 择 器 ) 、 列 表 类 视图 的 用 法 〈 基 本 适配器 、 列 表 视图 、 网 格 视图 ) 、 翻 页 类 视图 的 基本 
用 法 ( 翻 页 视图 、 翻 页 适配器 、 翻 页 标题 栏 》、 碎 片 的 用 法 (静态 注册 方式 、 动 态 注册 方式 、 
碎片 适配器 ) 、Broadcast 组 件 的 基本 用 法 〈 发 送 广播 、 接 收 、 定 时 器 广播 ) 。 中 间 穿 插 了 实 
战 模块 的 运用 ， 如 改进 后 的 购物 车 、 改 进 后 的 启动 引导 页 等 。 最 后 设计 了 两 个 实战 项 目 ， 一 个 
是 “万 年 历 ”， 另 一 个 是 “日 程 表 ”。 在 “万年历 ”的 项 目 编码 中 ,采用 前 面 介绍 的 部 分 控件 ， 
并 介绍 了 月 份 选择 器 的 实现 技巧 。 在“ 日程 表 ”的 项 目 编码 中 ,采用 本 章 介 绍 的 大 部 分 控件 与 
适配器 ， 以 及 广播 发 送 和 广播 接收 器 的 处 理 ， 并 介绍 了 震动 器 的 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 3 种 开发 技能 : 

(1) 在 布局 文件 中 合理 使 用 本 章 学 到 的 控件 。 

(2) 在 代码 中 合理 调用 本 章 学 到 的 控件 和 适配器 的 相关 方法 。 

(3) 学 会 广播 组 件 Broadcast 的 用 法 ， 如 在 不 同 页 面 之 间 发 送 与 接收 广播 、 设 置 定时 器 
并 接收 定时 器 广播 等 。 


本 章 介绍 App 开发 经 常 涉 及 的 自 定义 控件 相关 技术 , 主要 包括 自 定义 视图 的 过 程 与 步骤 、 
自 定义 动画 的 原理 与 实现 、 自 定义 对 话 框 的 概念 与 示例 、 自 定义 通知 栏 的 用 法 与 定制 ， 另 外 介 
绍 四 大 组 件 之 一 的 服务 Service 的 生命 周期 与 启 停 方式 。 最 后 结合 本 章 所 学 的 知识 ， 演 示 一 个 
实战 项 目 “ 手 机 安全 助手 ”的 设计 与 实现 。 


6.1 自 定 义 视图 


本 节 介 绍 自 定义 视图 的 过 程 ， 包 括 声明 属性 与 编写 代码 两 个 过 程 。 编 写 代码 的 过 程 分 为 
构造 对 象 、 测量 尺寸 、 绘 制 视图 3 个 步骤 。 另外, 详细 说 明 绘制 视图 的 3 种 途径 : 重 写 onLayout 
方法 、 重 写 onDraw 方法 和 重 写 dispatchDraw 方法 。 


6.1.1 声明 属性 


Android 自 带 的 视图 有 时 无 法 满足 实际 需求 ， 这 种 情况 下 开发 者 就 得 自 定义 视图 。 自 定义 
视图 好 比 自己 造 车 ， 造 车 比 开车 难 很 多 ,不 过 只 要 找到 窍门 ， 其 实 也 没有 想象 得 那么 难 。 自 定 
义 视图 涉及 许多 概念 ,为 了 使 读者 更 容易 理解 ， 下 面 从 一 个 小 例子 入 手 ， 先 产生 感性 认识 再 学 
习 理 论 知识 。 

第 5 章 提 到 PagerTitleStrip 和 PagerTabStrip 无 法 在 布局 文件 中 指定 文字 样式 , 只 能 在 代码 
中 设置 ， 让 人 很 不 习惯 , 如果 可 以 直接 指定 textColor 和 textSize 属性 就 会 好 很 多 。 现在 我 们 小 
试 牛刀 ， 通 过 扩展 自 定义 属性 ， 以 满足 在 布局 文件 指定 属性 的 要 求 。 具 体 步骤 如 下 : 

(301 在 res\values 目录 下 创建 attrs.xml。 其 中 ，declare-styleable 的 name 属性 值 表示 新 视 
名 为 CustomPagerTab， 两 个 attr 节点 表示 新 增 的 两 个 属性 分 别 是 textColor 和 textSize。 文 件 内 容 
如 下 : 














出 
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<resources> 
<declare-styleable name="CustomPagerTab"> 
<attr name="textColor" format="color" /> 
<attr name="textSize" format="dimension" /> 
</declare-styleable> 
</resources> 


人 在 代码 的 widget 目录 中 创建 CustomPagerTab.java， 填 入 以 下 代码 : 


public class CustomPagerTab extends PagerTabStrip { 
private int textColor = Color.BLACK; // 文本 颜色 
private int textSize= 15; // 文本 大 小 


public CustomPagerTab(Context context) { 
super(context); 
} 


public CustomPagerTab(Context context, AttributeSet attrs) { 
super(context, attrs); 
if (attrs != null) { 
/ 根据 CustomPagerTab 的 属性 定义 ， 从 布局 文件 中 获取 属性 数组 描述 
TypedArray attrArray = getContext().obtainStyledAttributes(attrs, 
R.styleable.CustomPagerTab); 
/ 根据 属性 描述 定义 ， 获 取 布 局 文件 中 的 文本 颜色 
textColor = attrArray.getColor(R.styleable.CustomPagerTab_textColor, textColor); 
/ 根据 属性 描述 定义 ， 获 取 布 局 文件 中 的 文本 大 小 
// getDimension 得 到 的 是 px 值 ， 需 要 转换 为 sp 值 
textSize = Utils.px2sp(context, attrArray.getDimension(R.styleable.CustomPagerTab_textSize, 
textSize)); 
/ 回收 属性 数组 描述 
attrArray.recycle(); 


1// ”WPagerTabStrip 没有 三 个 参数 的 构造 函数 
// public CustomPagerTab(Context context, AttributeSet attrs, int defStyleAttr) { 
/1 } 


@Override 

protected void onDraw(Canvas canvas) { // 绘制 函数 
setTextColor(textColor);，// 设置 标题 文字 的 文本 颜色 
setTextSize(TypedValue.COMPLEX_UNIT_SP, textSize); // 设置 标题 文字 的 文本 大 小 
super.onDraw(canvas); 
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} 


03 在 布局 文件 根 节 点 增加 命名 空间 声明 xmlns:app="http:/schemas.android.comy/ 

apk/res-auto"， 并 把 android.support.v4.view.PagerTabStrip 的 节点 名 称 改 为 自 定义 视图 的 全 路 径 名 称 

(如 com.example.custom.widget.CustomPagerTab) ， 同 时 在 该 节点 下 指定 新 增 的 两 个 属性 一 一 
app:textColor 与 app:textSize。 修 改 后 的 布局 文件 代码 如 下 : 


























<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation= "vertical" 
android:padding="10dp" > 


<android.support.v4.view.ViewPager 
android:id="@+id/vp_content" 
android:layout_width="match_parent" 
android:layout_height="400dp" > 


<!-- 这 里 使 用 自 定义 控件 的 全 路 径 名 称 ， 其 中 textColor 和 textSize 为 自 定义 的 属性 -> 

<com.example.custom.widget.CustomPagerTab 
android:id="(@+id/pts_tab" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
app:textColor="(@color/red" 
app:textSize="20sp" /> 

</android.support.v4.view.ViewPager> 
</LinearLayout> 


完成 以 上 代码 的 修改 后 运行 App， 实 现 的 效果 如 图 6-1 
所 示 ， 此 时 翻 页 标题 栏 的 文字 颜色 变 为 红色 ,字体 也 变 大 了 。 

在 自 定义 视图 的 步骤 1 中 ，attr 节点 的 name 表示 新 属性 ne 
的 名 称 ，format 表示 新 属性 的 格式 〈 数 据 类 型 ) ;在 步骤 2 
中 ,调用 getColor 方 法 获取 颜色 值 ,调用 getDimensionPixelSize 
方法 获取 文字 大 小 ， 不 同 的 数据 类 型 调用 不 同 的 获取 方法 。 
有 关 属 性 类 型 及 其 获取 方法 的 对 应 说 明 见 表 6-1。 








图 6-1 自 定义 的 翻 页 标题 栏 
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表 6-1 ”属性 类 型 的 取 值 说 明 
属性 类 型 获取 方法 说 明 
boolean getBoolean 布尔 值 。 取 值 为 true 或 false 
integer getInt 整 型 值 
float getFloat 浮 点 值 
string getString 字符 串 
color getColor 颜色 值 。 取 值 为 开头 带 # 的 六 位 或 八 位 十 六 进 制 数 
dimension getDimension 尺寸 值 。 取 值 为 末尾 带 dp 的 尺寸 数值 
dimension getDimensionPixelSize 字体 大 小 。 取 值 为 末尾 带 px 的 尺寸 数值 
fraction getFraction 百分数 。 取 值 为 末尾 带 % 的 百分数 
reference getResourceld 参考 某 一 资源 。 取 值 如 @drawable/ic_launcher 
enum getInt 枚 举 值 
flag getInt 标志 位 


表 6-1 的 enum 类 型 与 flag 类 型 的 使 用 稍微 复杂 ， 枚 举 类 型 的 属性 常见 的 有 LinearLayout 
的 orientation 和 ImageView 的 scaleType; 标志 类 型 的 属性 常见 的 有 TextView 的 gravity 和 
EditText 的 inputType。 下 面 是 枚 举 类 型 的 属性 声明 例子 ， 注 意 给 出 了 多 个 枚 举 值 : 


<declare-styleable name="CustomPagerTab"> 


<attr name="customOrientation"> 


<enum name="horizontal" value="0" /> 


<enum name="vertical" value="1" /> 
</attr> 
</declare-styleable> 


下 面 是 标志 类 型 的 属性 声明 例子 ， 注 意 给 出 了 多 个 标志 位 的 取 值 : 


<declare-styleable name="CustomPagerTab"> 
<attr name="customGravity"> 
<flag name = "center" value = "0" > 


<flag name = "left" value = "1" /> 


<flag name = "top" value ="2" /> 
<flag name = "right" value = "4" /> 
<flag name = "bttom" value = "8" /> 
</attr> 
</declare-styleable> 


6.1.2 ”构造 对 象 
新 增 视图 属性 的 声明 很 简单 ， 麻 烦 的 是 在 代码 中 进行 视图 的 自 定义 处 理 。 自 定义 视图 的 


编码 主要 由 3 部 分 组 成 : 
(1) 重 写 构造 函数 ， 初 始 化 该 视图 的 自 有 属性 。 
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写 测量 函数 onMeasure, 计算 该 视图 的 宽 与 高 (一 般 只 有 复杂 视图 才 重 写 该 函数 ) 。 
(3) 重 写 绘图 函数 onLayout、onDraw、dispatchDraw， 视 情况 重 写 3 个 中 的 一 个 或 多 个 。 


- 般 要 重 写 3 个 构造 函数 。 前 面 在 演示 新 控件 CustomPagerTab 时 ， 示 例 代码 给 出 了 3 个 
构造 函数 (实际 只 实现 了 两 个 ) ， 分 别 是 : 

(1) 只 带 一 个 参数 的 public CustomPagerTab (Context context)。 在 代码 中 声明 对 象 时 采用 

(2) 带 两 个 参数 的 public CustomPagerTab (Context context,AttributeSet attrs)。 在 布局 文件 
中 引用 自 定义 视图 时 采用 该 构造 函数 。 

(3) 带 3 个 参数 的 public CustomPagerTab (Context context，AttributeSet attrs，int 
defStyleAttr)。 该 构造 函数 的 作用 是 : 除了 布局 文件 中 指定 的 属性 ， 另 外 在 代码 中 指定 默认 风 
格 。 第 3 个 参数 defStyleAttr 是 一 种 特殊 属性 ， 类 型 既 非 整 型 也 非 字 符 串 ， 而 是 参照 类 型 
(reference， 需 要 在 styles.xml 中 另外 定义 ) 。 有 具体 使 用 步骤 如 下 : 

C01 在 styles.xml 中 定义 一 种 风格 样式 。 

02 在 attrs.xml 中 声明 该 风格 样式 的 参照 属性 ， 举 例如 下 : 

<attr name="CustomizeStyle" format="reference" /> 

C03 在 代码 中 由 第 二 种 构造 函数 调用 第 三 种 构造 函数 ， 在 调用 时 把 该 参照 属性 传 到 第 三 

个 参数 中 ， 示 例 代码 如 下 : 


public CustomPagerTab(Context context, AttributeSet attrs) { 
this(context, attrs, R.attr.CustomizeStyle); 


) 








如 





public CustomPagerTab(Context context, AttributeSet attrs, int defStyleAttr) { 
super(context, attrs, defStyleAttr); 
if (attrs !{= nulD) { 
TypedArray attrArray = getContext().obtainStyledAttributes( attrs, 
R.styleable.CustomPagerTab, defStyleAttr, R.style.DefaultCustomizeStyle); 
/此 处 省 略 各 个 属性 值 的 读 取 
attrArray.recycle(); 


这 样 ， 系 统 在 寻找 该 视图 的 属性 时 就 会 先 找 布局 文件 ， 再 找 attrs.xml 中 声明 的 
R.attr.CustomizeStyle 风格 样式 ,最 后 找 styles.xml 中 R.style.DefaultCustomizeStyle 的 风格 样式 。 
第 三 种 构造 函数 用 得 不 多 ， 无 须 深入 研究 ， 了 解 即 可 。 


6.1.3 ”测量 尺寸 


自 定义 视图 的 第 二 步 是 测量 尺寸 。 大 家 知道 ， 添 加 视图 的 目的 是 在 屏幕 上 显示 期 望 的 图 
案 。 因 此 ,在 绘制 图 案 之 前 系统 得 先知 道 这 个 图 案 的 尺寸 , 即 宽 和 高 。 一 般 在 布局 文件 中 对 视 


第 6 章 自 定义 控件 | 193 





图 的 宽 和 高 有 3 种 赋值 方式 ， 具 体 说 明 见 表 6-2。 
表 6-2 尺寸 大 小 的 3 种 赋值 方式 











XML 中 的 尺寸 类 型 LayoutParams 类 的 尺寸 类 型 说 明 

match_parent MATCH PARENT 与 上 级 视图 大 小 一 样 
wrap_content WRAP_ CONTENT 按照 自身 尺寸 进行 适 配 
**dp 整 型 数 具体 的 尺寸 数值 








方式 1 和 方式 3 都 好 办 ， 要 么 取 上 级 视图 的 数值 ， 要 么 取 具 体 数值 。 难 办 的 是 方式 2， 这 
个 尺寸 究竟 要 如 何 度量 ， 不 可 能 让 开发 者 人 手 一 把 尺子 在 屏幕 上 比划 。Android 提供 了 相关 度 
量 方法 ， 可 以 在 不 同情 况 下 进行 尺寸 测量 。 需 要 测量 的 对 象 主要 有 3 种 ， 分 别 是 文本 尺寸 、 图 
形 尺 寸 和 布局 尺寸 。 


1. 文本 尺寸 测量 


文本 尺寸 分 为 文本 的 宽度 和 高 度 ， 要 根据 文本 大 小 分 别 进行 计算 。 其 中 ， 文 本 宽度 使 用 
Paint 类 的 measureText 方法 测量 ， 具 体 代码 如 下 : 
// 获取 指定 文本 的 宽度 〈 其 实 就 是 长 度 ) 
public static float getTextWidth(String text, float textSize) { 
if (TextUtils.isEmpty(text)) { 
return 0; 


b 

Paint paint = new Paint(); / 创建 一 个 画笔 对 象 

paint.setTextSize(textSize); / 设置 画笔 的 文本 大 小 

return paint.measureText(text); / 利用 画笔 丈量 指定 文本 的 宽度 
} 


文本 高 度 的 计算 要 烦琐 一 些 , 用 到 了 FontMetrics 类 , 该 类 提供 了 5 个 与 高 度 相 关 的 属性 ， 
详细 说 明 见 表 6-3 。 


表 6-3 ”FontMetrics 类 的 距离 属性 说 明 

















FontMetrics 类 的 距离 属性 说 明 

top 行 的 顶部 与 基线 的 距离 
ascent 字符 的 顶部 与 基线 的 距离 
descent 字符 的 底部 与 基线 的 距离 
bottom 行 的 底部 与 基线 的 距离 
leading 行 间距 





之 所 以 区 分 这 些 属性 ， 是 为 了 计算 不 同 规格 的 高 度 。 如 果 要 得 到 文本 自身 的 高 度 ， 高 度 
值 就 是 descent 减 去 ascent; 如 果 要 得 到 文本 所 在 行 的 行 高 ， 高 度 值 就 是 bottom 减 去 top 再 加 
上 leading。 具 体 的 高 度 计算 代码 如 下 : 


/ 获取 指定 文本 的 高 度 





194 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


public static float getTextHeight(String text, float textSize) { 
Paint paint = new Paint(); / 创建 一 个 画笔 对 象 
paint'setTextSize(textSize); / 设置 画笔 的 文本 大 小 
FontMetrics fm = paint.getFontMetrics(); / 获取 画笔 默认 字体 的 度量 衡 
return fm.descent - fm.ascent; // 返回 文本 自身 的 高 度 
//return fim.bottom - fm.top + fin.leading; / 返回 文本 所 在 行 的 行 高 

} 


下 面 看 看 文本 尺寸 的 度量 结果 ， 当 字体 大 小 为 17sp 时 , 示例 文本 的 宽度 为 119、 高 度 为 19， 
如 图 6-2 所 示 ; 当 字体 大 小 为 25sp 时 ， 示 例文 本 的 宽度 为 175、 高 度 为 29， 如 图 6-3 所 示 。 


Custom Custom 


字体 大 小 : 17sp 字体 大 小 ; 25sp 


下 面 文字 的 宽度 是 119 ,高 度 是 19 下 面 文字 的 宽度 是 175 ,高 度 是 29 
生地 人 每 逢 佳节 倍 思 亲 


图 6-2 字体 大 小 为 17sp 时 的 尺寸 图 6-3 字体 大 小 为 25sp 时 的 尺寸 
2. 图 形 尺寸 测量 


相对 于 文本 尺寸 ， 图 形 尺寸 的 计算 反而 简单 些 ， 因 为 Android 提供 了 可 以 直接 使 用 的 宽 、 
高 获取 方法 。 如 果 图 形 是 Bitmap 格式 ， 就 通过 getWidth 和 getHeight 方法 获取 位 图 对 象 的 宽 
度 和 高 度 ; 如 果 图 形 是 Drawable 格式 ,就 通过 getIntrinsicWidth 方法 获取 该 图 形 的 宽度 ， 通 过 
getIntrinsicHeight 方法 获取 该 图 形 的 高 度 。 


3. 布局 尺寸 测量 


文本 尺寸 测量 主要 用 于 TextView、Button 等 文本 控件 , 图形 尺寸 测量 主要 用 于 ImageView、 
ImageButton 等 图 像 控件 。 在 实际 开发 中 ， 有 更 多 场合 需要 测量 布局 视图 的 尺寸 。 布 局 视图 内 
部 可 能 有 文本 控件 、 图 像 控件 ， 还 可 能 有 padding 和 margin。 如 此 一 来 ， 对 布局 视图 的 内 部 控 
件 一 个 个 单独 测量 变 得 不 切实 际 。View 类 提供 了 一 种 对 布局 整体 进行 测量 的 思路 。 对 应 
layout_ width 和 layout_height 的 3 种 赋值 方式 ，Android 的 视图 提供 了 3 种 测量 模式 ， 有 具体 取 
值 说 明 见 表 6-4。 





表 6-4 测量 模式 的 取 值 说 明 











MeasureSpec 类 的 测量 模式 视图 宽 、 高 的 赋值 方式 说 明 

AT_MOST MATCH PARENT 达到 最 大 

UNSPECIFIED WRAP CONTENT 未 指定 (实际 就 是 自 适 应 ) 
EXACTLY 具体 dp 值 精确 尺寸 








围绕 这 3 种 模式 衍生 了 相关 度量 方法 ， 如 ViewGroup 类 的 getChildMeasureSpec 方法 、 
MeasureSpec 类 的 makeMeasureSpec 方法 、View 类 的 measure 方法 等 。 具体 的 测量 原理 可 以 不 
用 深究 ， 下 面 直接 切入 正题 ， 看 下 测量 尺寸 的 实现 代码 : 
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/ 计算 指定 线性 布局 的 实际 高 度 
public static float getRealHeight(View child) { 
LinearLayout llayout = (LinearLayout) child; 
/ 获得 线性 布局 的 布局 参数 
ViewGroup.LayoutParams params = llayout.getLayoutParams(); 
让 (params =— null) { 
params = new ViewGroup.LayoutParams( 
LayoutParams.MATCH PARENT, LayoutParams.WRAP CONTENT); 
} 
/ 获得 布局 参数 里 面 的 宽度 规格 
int widthSpec = ViewGroup.getChildMeasureSpec(0, 0, params.width); 
int heightSpec; 
让 (params.height > 0) { / 高 度 大 于 0， 说 明 这 是 明确 的 dp 数值 
// 按照 精确 数值 的 情况 计算 高 度 规格 
heightSpec = View.MeasureSpec.makeMeasureSpec(params.height, MeasureSpec.EXACTLY); 
}else { /MATCH PARENT=-1，WRAP_CONTENT=-2， 所 以 二 者 都 进入 该 分 支 
/ 按照 不 确定 的 情况 计算 高 度 规则 
heightSpec = View.MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED); 
1 
/ 重新 进行 线性 布局 的 宽 高 丈量 
llayout.measure(widthSpec, heightSpec); 
/ 获得 并 返回 线性 布局 丈量 之 后 的 高 度数 值 。 调 用 getMeasuredWidth 方法 可 获得 宽度 数值 
return llayout.getMeasuredHeight(); 


} 
现在 很 多 App 页 面 都 提供 下 拉 刷 新 功能 ， 需 要 计算 
下 拉 刷 新 的 头 部 高 度 ， 以 便 在 下 拉 时 判断 整个 页 面 要 拉 
动 多 少 距 离 。 下 面 演示 下 拉 刷 新 的 头 部 高 度 ， 如 图 6-4 
所 示 。 头 部 布局 中 有 图 像 、 文 字 和 间隔 ， 调 用 
getRealHeight 方法 计算 得 到 的 布局 高 度 为 170。 


6.1.4” 宽 高 尺寸 的 动态 调整 


-个 视图 的 宽 和 高 ， 其 实在 页 面 布局 的 时 候 就 决定 
了 ， 视 图 节点 的 android:layout_width 属性 指定 了 该 视图 
的 宽度 ， 而 android:layout_height 属性 指定 了 该 视图 的 高 度 。 这 两 个 属性 又 有 三 种 取 值 方式 ， 
分 别 是 : 取 值 match_parent 表示 与 上 级 视图 一 样 尺寸 , 取 值 wrap_content 表示 按照 自身 内 容 的 
实际 尺寸 ， 最 后 一 种 则 直接 指定 了 有 具体 的 dp 数值 。 在 多 数 情 况 之 下 ， 系 统 按照 这 三 种 取 值 方 
式 ， 完 全 能 够 自动 计算 正确 的 视图 宽度 和 视图 高 度 。 
当然 也 有 例外 ， 像 列表 视图 ListView 就 是 个 另类 ， 尽 管 ListView 在 多 数 场 合 的 高 度 计 算 
也 不 会 出 错 , 但 是 把 它 放 到 ScrollView 之 中 便 出 现 问题 了 。ScrollView 本 身 叫 做 滚动 视图 ， 而 
列表 视图 ListView 也 是 可 以 滚动 的 ， 于 是 一 个 滚动 视图 嵌 套 另 一 个 也 能 滚动 的 视图 ， 那 么 在 
双方 的 重 登 区 域 ， 上 下 滑动 的 手势 究竟 表示 要 滚动 哪个 视图 ? 这 个 滚动 冲突 的 问题 ,不光 令 


= 


i 
炳 “ 轻 轻 下 拉 ， 刷 新 精彩 … 


上 面 下 拉 刷 新 头 部 的 高 度 是 170.000000 





图 64 布局 视图 的 高 度 测量 结果 
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发 者 脑袋 浆 糊 ， 便 是 Android 系统 也 得 神经 错乱 。 所 以 Android 目前 的 处 理 对 策 是 : 如 果 
ListView 的 高 度 被 设置 为 wrap_content， 则 此 时 列表 视图 只 显示 一 行 的 高 度 ， 然 后 布局 内 部 只 
支持 滚动 ScrollView。 

如 此 虽然 滚动 冲突 的 问题 暂时 解决 ， 但 是 又 带 来 一 个 新 间 题 ， 好 好 的 列表 视图 仅仅 显示 

-行内 容 , 这 让 出 不 了 头 的 剩余 列表 行情 何以 堪 ? 按照 用 户 正 常 的 思维 逻辑 , 列表 视图 应 该 显 

示 所 有 行 ， 并 且 列 表 内 容 要 跟着 整个 页 面 一 齐 向 上 或 者 向 下 滚动 。 显 然 此 时 系统 对 ListView 
的 默认 处 理 方式 并 不 符合 用 户 习 惯 ,只 能 对 其 进行 改造 使 之 满足 用 户 的 使 用 习惯 。 改 造 列 表 视 
图 的 一 个 可 行 方案 , 便 是 重 写 它 的 测量 函数 onMeasure, 不 管 布局 文件 中 设 定 的 视图 高 度 为 何 ， 
都 把 列表 视图 的 高 度 改 为 最 大 高 度 ， 即 所 有 列表 项 高 度 加 起 来 的 总 高 度 。 

根据 以 上 思路 自 定义 一 个 扩展 自 ListView 的 不 滚动 列表 视图 NoScrollListView, 它 的 实现 
代码 如 下 所 示 : 


public class NoScrollListView extends ListView { 








public NoScrollListView(Context context) { 
super(context); 
1 


public NoScrollListView(Context context, AttributeSet attrs) { 
Super(context attrs); 


public NoScrollListView(Context context AttributeSet attrs, int defStyle) { 
Super(context attrs, defStyle); 
上 


// 重 写 onMeasure 方法 ， 以 便 自 行 设 定 视图 的 高 度 
public void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 
/ 将 高 度 设 为 最 大 值 ， 即 所 有 项 加 起 来 的 总 高 度 
int expandSpec = MeasureSpec.makeMeasureSpec( 
IntegerMAX_VALUE >> 2, MeasureSpec.AT MOST); 
super.onMeasure(width MeasureSpec, expandSpec); 


} 

接 下 来 为 了 方便 演示 改造 前 后 列表 视图 的 界面 效果 对 比 ， 在 一 个 页 面 布 局 中 放 入 
ScrollView 节点 ， 然 后 在 该 节点 下 面 同时 添加 ListView 节点 ， 以 及 自 定义 的 NoScrollListView 
节点 。 回 到 该 页 面 的 Activity 代码 , 给 ListView 和 NoScrollListView 两 个 控件 对 象 设置 一 模 一 
样 的 行星 列表 数据 ， 具 体 页 面 代码 如 下 所 示 : 


public class OnMeasureActivity extends AppCompatActivity { 





(@Override 
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protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_on_measure); 
PlanetListAdapter adapterl = new PlanetListAdapter(this, Planet.getDefaultList()); 
// 从 布局 文件 中 获取 名 叫 lv_planet 的 列表 视图 
/lv_planet 是 系统 自 带 的 ListView， 被 ScrollView 嵌 套 只 能 显示 一 行 
ListView Iv_planet = findViewById(R.id.Iv_planeb; 
lv_planetsetAdapter(adapterl); 
lv_planet.setOnItemClickListener(adapter] ); 
lv_planetsetOnItemLongClickListener(adapterl); 
PlanetListAdapter adapter2 = new PlanetListAdapter(this, Planet.getDefaultList()); 
/ 从 布局 文件 中 获取 名 叫 nslv_planet 的 不 滚动 列表 视图 
/nslv_planet 是 自 定义 控件 NoScrollListView， 会 显示 所 有 行 
NoScrollListView nslv_planet = findViewById(R.id.nslv_planet); 
nslv_planet.setAdapter(adapter2); 
nslv_planet.setOnItemClickListener(adapter2); 
nslv_planetsetOnItemLongClickListener(adapter2); 


} 


重新 编译 运行 App, 然后 上 下 滑动 测试 页 面 , 即 可 观察 到 两 种 列表 的 区 别 。 如 图 6-5 所 示 ， 
这 是 测试 页 面 的 初始 界面 ， 此 时 系统 自 带 的 ListView 仅仅 显示 一 行内 容 ， 而 开发 者 自 定义 的 
NoScrollListView 显示 多 行内 容 。 接 着 把 测试 页 面 往 上 拉动 ， 滚 动 后 的 界面 如 图 6-6 所 示 ， 此 
时 系统 自 带 的 ListView 带 着 仅 有 的 一 行 完 全 向 上 滚 没 了 , 而 开发 者 自 定义 的 NoScrollListView 
随 着 上 拉手 势 持续 滚动 ， 可 见 NoScrollListView 内 部 的 列表 项 全 部 展示 了 出 来 。 












custom 










下 面 是 系统 自 带 的 ListView 


水 星 
交办 和 所 旦 小 的 一 硬 
行星 ， 也 是 刘 太 阳 最 近 的 和 


水 星 


末 相 太阳 权 人 二 是 全 也 屋 的 大 
行星 ， 也 是 元 太阳 最 近 的 / 


水 星 





水 旺 是 太阳 系 八 大 行星 最 内 倒 也 是 最 小 的 一 四 
行星 ， 亿 是 庚 太阳 最 近 的 行星 


金星 

全 旺 是 太阳 系 八大 行星 之 一 ,排行 第 一 ,下放 
大 0.725 天 文 单位 
地 球 


地 球 且 太阳系 八大 行星 之 一 ， 撞 和 
寺中 和 友和 下 有 


| x 呈 是 太阳 系 八 大 行 呈 之 一 ， 拓 行 第 四 ,局 于 
类 地 行星 ， 直 径 约 为 地 球 的 53%6 


木星 是 太阳系 八大 行星 中 体积 本 大、 自转 最 
- 9 和 是 》 拓 第 ey 

但 为 大 天 系 中 其它 七 大 行星 人 量 怠 82.5| 
入 


士 旺 为 太阳 系 八大 行星 之 一 ,排行 第 六 ,体积 
砚 次 于 木星 















6-5 系统 自 带 的 ListView 顽 套 效果 图 6-6 自 定义 的 ListView 展开 效果 
除了 解决 列表 视图 的 嵌 套 展示 问题 , 重 写 onMeasure 函数 还 有 另外 一 个 用 途 。 由 于 手机 屏 


上 由 
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幕 既 可 以 竖 屏 显示 , 也 可 以 横 屏 显示 , 因此 为 了 让 一 个 正方 形 视图 无 论 竖 屏 还 是 横 屏 都 能 正常 
展示 ， 就 得 重 写 onMeasure 方法 。 当 该 视图 的 初始 宽度 小 于 初始 高 度 时 ， 则 缩短 高 度 使 之 与 宽 
度 一 样 长 ; 否则 意味 着 初始 宽度 大 于 初始 高 度 , 此 时 应 缩短 宽度 使 之 与 高 度 一 样 长 。 这 样 保证 
了 不 管 竖 屏 还 是 横 屏 ， 正 方形 视图 都 能 完整 地 显示 在 屏幕 上 ， 而 不 会 超出 屏幕 范围 。 
正方 形 视图 的 具体 应 用 参见 第 9 章 指南 针 一 节 用 到 的 罗盘 视图 CompassView， 下 面 是 罗 
盘 视图 重 写 后 的 onMeasure 代码 片段 : 


// 重 写 onMeasure 方法 ， 使 得 该 视图 无 论 竖 屏 还 是 横 屏 都 保持 正方 形状 
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 
int width = View.MeasureSpec.getSize(widthMeasureSpec); 
int height = View.MeasureSpec.getSize(heightMeasureSpec); 
证 (width < heighb ! / 宽度 比 高 度 小 ， 则 缩短 高 度 使 之 与 宽度 一 样 长 
super.onMeasure(widthMeasureSpec, width MeasureSpec); 
} else { / 宽度 比 高 度 大 ， 则 缩短 宽度 使 之 与 高 度 一 样 长 
SuperonMeasure(heightMeasureSpec, heightMeasureSpec); 














} 


6.1.5 ”绘制 视图 


在 自 定义 视图 中 ， 可 重 写 3 个 函数 用 于 视图 的 绘制 ， 分 别 是 onLayout、onDraw 和 
dispatchDraw。 这 3 个 函数 的 执行 顺序 是 onLayout 一 onDraw 一 dispatchDraw。 其 中 ，onLayout 
和 dispatchDraw 通常 用 于 布局 类 视图 。 下 面 逐 一 介绍 这 3 个 函数 的 用 途 与 用 法 。 


1. onLayout 


onLayout 方法 用 于 定位 子 视图 在 本 布局 视图 中 的 位 置 。 该 方法 的 入 参 表示 本 布局 在 上 级 
视图 的 上 、 下 、 左 、 右 位 置 ， 子 视图 在 本 布局 中 的 位 置 要 另行 计算 ， 计 算 完毕 调用 子 视图 的 
layout 方 法 调整 子 视图 的 位 置 。 

为 直观 理解 onLayout 的 用 法 ， 下 面 给 出 自 定义 偏 移 布 局 的 代码 : 

public class OffsetLayout extends AbsoluteLayout { 

private int mOffsetHorizontal = 0;， / 水 平方 向 的 偏 移 量 
private int mOffsetVertical = 0; // 垂直 方向 的 偏 移 量 


public OffsetLayout(Context context) { 
super(context); 
} 


public OffsetLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 


4 


// 重 写 onLayout 方法 ， 意 在 调整 下 级 视图 的 方位 
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protected void onLayout(boolean changed, int |, int t, intr int b) { 
for (inti= 0; i< getChildCountO: i++) { 

View child = getChildAt(i); / 获得 第 i 个 子 视图 

if (child.getVisibility() != GONE) { 
// 计算 子 视图 的 左边 偏 移 数值 
intnew_left =(r- 1)/2 -child.getMeasured Width()/ 2 + mOffsetHorizontal; 
// 计算 子 视图 的 上 方 偏 移 数值 
intnew_top=(b-t)/2-child.getMeasuredHeight() / 2 + mOffsetVertical; 
/ 根据 最 新 的 上 下 左右 四 周边 界 ， 重 新 放置 该 子 视图 
child.layout(new_left, new_top, 

new_left + child.getMeasured Width(), new_top + child.getMeasuredHeightO); 


) 


/ 设置 水 平方 向 上 的 偏 移 量 

public void setOffsetHorizontal(int offset) { 
mOffsetHorizontal = offset; 
mOffsetVertical = 0; 
/ 请 求 重新 布局 ， 此 时 会 触发 onLayout 方法 
requestLayout(); 

’ 


// 设置 垂直 方向 上 的 偏 移 量 

public void setOffsetVertical(int offset) { 
mOffsetHorizontal = 0; 
mOffsetVertical = offset: 
/ 请 求 重新 布局 ， 此 时 会 触发 onLayout 方法 
requestLayout(); 


} 

该 偏 移 布 局 可 根据 设 定 的 偏 移 值 动态 调整 子 视图 的 偏 移 位 置 。 页 面 代 码 可 直接 调用 
OffsetLayout 对 象 的 setOffsetHorizontal 方法 或 setOffsetVertical 方法 ， 完 成 水 平 或 乖 直 方向 的 
偏 移 值 设置 。 如 图 6-7 一 图 6-10 所 示 ， 这 4 张 图 分 别 展示 了 不 同 偏 移 值 的 效果 。 其 中 ， 图 6-7 
所 示 为 无 偏 移 ， 图 6-8 所 示 为 向 左 偏 移 50dp， 图 6-9 所 示 为 向 右 偏 移 50 dp， 图 6-10 所 示 为 向 
上 偏 移 50 dp。 
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向 左 偏 移 50 
图 6-7 无 偏 移 的 情况 图 6-8 向 左 偏 移 50dp 
向 右 偏 移 50 : 向 上 偏 移 50 
图 6-9 向 右 偏 移 50dp 图 6-10 向 上 偏 移 50dp 
2. onDraw 


onDraw 是 最 常 使 用 的 绘图 方法 ， 该 方法 的 入 参 为 Canvas 画布 对 象 , 在 画布 上 绘图 相当 于 
在 屏幕 上 绘图 。 绘 图 本 身 是 个 很 大 的 课题 ， 画 布 的 用 法 也 多 种 多 样 ， 如 Canvas 提供 了 3 类 方 
法 ， 分 别 是 划 定 可 绘制 的 区 域 、 在 区 域内 部 绘制 图 形 和 画布 的 控制 操作 。 


(1) 划 定 可 绘制 的 区 域 

虽然 本 视图 内 的 所 有 区 域 都 是 可 以 绘制 的 ， 但 是 有 时 候 开发 者 只 想 在 某 个 矩形 区 域内 部 
画 画 ， 这 时 在 绘图 之 前 就 得 指定 允许 绘图 的 区 域 界 限 ， 相 关 方法 说 明 如 下 : 

e clipPath: 裁剪 不 规则 曲线 区 域 。 

e clipRect: 裁剪 矩形 区 域 。 

e clipRegion: 裁剪 一 块 组 合 区 域 。 


(2 ) 在 区 域内 部 绘制 图 形 
该 类 方法 用 来 绘制 各 种 基本 几何 图 形 ， 相 关 方 法 说 明 如 下 : 
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drawArc: 绘制 扇形 / 弧 形 。 第 4 个 参数 为 true 时 画 扇形 、 为 false 时 画 弧 形 。 
drawBitmap: 绘制 图 像 。 

drawCircle: 绘制 圆 形 。 

drawLine: 绘制 直线 。 

drawOval: 绘制 椭圆 。 

drawPath: 绘制 路 径 ， 即 不 规则 曲线 

drawPoint: 绘制 点 。 

drawRect: 绘制 矩形 。 

drawRoundRect: 绘制 圆 角 和 矩形。 

drawText: 绘制 文本 。 





(3 ) 画布 的 控制 操作 
控制 操作 包括 旋转 、 缩 放 、 平 移 以 及 存 取 画 布 状态 的 操作 ， 相 关 方 法 说 明 如 下 : 


rotate: 旋转 画布 。 
scale: 缩放 画布 。 
translate: 平移 画布 。 
save: 保存 画布 状态 。 
restore: 恢复 画布 状态 。 


上 面 绘图 用 的 draw*** 方 法 只 是 指定 绘制 哪个 几何 图 形 ,真正 的 细节 描绘 还 要 靠 画笔 Paint 
类 实现 。Paint 类 定义 了 画笔 的 颜色 、 样 式 、 粗 细 、 阴 影 等 ， 常 用 方法 说 明 如 下 : 


下 面 演示 不 同 图 形 的 给 


setAntiAlias: 设置 是 否 使 用 抗 饮 齿 功能 。 主 要 用 于 画 圆圈 等 曲线 。 

setDither: 设置 是 否 使 用 防 拌 动 功 能 。 

setColor: 设置 画笔 的 颜色 。 

setShadowLayer: ”设置 画笔 的 阴影 区 域 与 颜色 。 

setStyle: 设置 画笔 的 样式 。Style.STROKE 表示 线条 ，Style.FILL 表示 填充 。 
setStrokeWidth: 设置 画笔 线条 的 宽度 。 


调用 drawOval 方法 绘制 椭圆 ， 如 图 6-12 所 示 。 


疆 图 方式 ; 画 国 角 和 矩形 给 图 方式 : 





CC) 


图 6-11 绘制 圆 角 矩形 图 6-12 绘制 椭圆 





会 制 效果 。 调 用 drawRoundRect 方法 绘制 圆 角 和 矩形 ， 如 图 6-11 所 示 。 


Custom 


202 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


3. dispatchDraw 


dispatchDraw 与 onDraw 函数 一 样 都 是 绘图 方法 ， 区 别 在 于 onDraw 的 调用 在 绘制 子 视图 
之 前 ，dispatchDraw 的 调用 在 绘制 子 视图 之 后 。 如 果 不 想 自身 视图 被 子 视图 覆盖 ， 就 只 能 在 
dispatchDraw 方法 中 进行 绘图 处 理 。 
下 面 演示 onDraw 和 dispatchDraw 两 个 方法 之 间 的 区 别 ， 实 验 用 的 布局 代码 如 下 所 示 : 
public class DrawRelativeLayout extends RelativeLayout { 
private int mDrawType = 0; // 绘制 类 型 
private Paint mPaint = new Paint0; / 创建 一 个 画笔 对 象 





public DrawRelativeLayout(Context contexb { 
this(context, null); 
} 


public DrawRelativeLayout(Context context, AttributeSet attrs) { 

super(context, attrs); 

mPaint.setAntiAlias(true); / 设置 画笔 为 无 锯齿 

mPaint.setDither(true); / 设置 画笔 为 防 抖动 

mPaint.setColor(Color.BLACK);，// 设置 画笔 的 颜色 

mpPaint.setStrokeWidth(3); / 设置 画笔 的 线 宽 

mPaint.setStyle(Style.STROKE);，// 设置 画笔 的 类 型 。STROKE 表示 空心 ，FILL 表示 实心 
上 


// onDraw 方法 在 绘制 下 级 视图 之 前 调用 
protected void onDraw(Canvas canvas) { 
super.onDraw(canvas); 
int width = getMeasuredWidth0; // 获得 布局 的 实际 宽度 
int height = getMeasuredHeight(0; / 获得 布局 的 实际 高 度 
if (width > 0 && height > 0) { 
f(mDrawType 一 1) { // 绘制 矩形 
Rect rect = new Rect(0, 0, width, height); 
canvas.drawRect(rect, mPaint); 
} else if(mDrawType 一 2) { // 绘制 圆 角 矩形 
RectF rectF = new RectF(0, 0, width, height); 
canvas.drawRoundRect(rectF, 30, 30, mPaint); 
} else if (mDrawType 一 3) { // 绘制 圆圈 
int radius = Math.min(width, height) / 2; 
canvas.drawCircle(width / 2, height / 2, radius, mPaint); 
} else if(mDrawType 一 4) { // 绘制 椭圆 
RectF oval = new RectF(0, 0, width, height); 
canvas.drawOval(oval, mPaint); 
} else if(mDrawType 一 5) { // 绘制 矩形 及 其 对 角 线 
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Rect rect = new Rect(0, 0. width, height); 
canvas.drawRect(rect, mPaint); 
canvas.drawLine(0, 0, width, height, mPaint); 
canvas.drawLine(0, height, width, 0, mPaint); 


| 


// dispatchDraw 方法 在 绘制 下 级 视图 之 前 调用 
protected void dispatchDraw(Canvas canvas) { 
super.dispatchDraw(canvas); 
int width = getMeasuredWidth0; / 获得 布局 的 实际 宽度 
int height = getMeasuredHeightO0; / 获得 布局 的 实际 高 度 
if (width> 0 && height > 0) { 
让 (mDrawType 一 6) { // 绘制 矩形 及 其 对 角 线 
Rect rect = new Rect(0, 0, width, height); 
canvas.drawRect(rect, mPaint); 
canvas.drawLine(0, 0, width, height, mPaint); 
canvas.drawLine(0, height, width, 0, mPaint); 


} 


// 设置 绘制 类 型 

public void setDrawType(int type) { 
/ 背景 置 为 白色 ,目的 是 把 画布 擦 干净 
setBackgroundColor(Color WHITE); 
mDrawType = type; 
/ 立即 重新 绘图 ， 此 时 会 触发 onDraw 方法 和 dispatchDraw 方法 
invalidate(); 


上 

观察 onDraw 与 dispatchDraw 两 种 绘图 方式 的 效果 对 比 , 如 图 6-13 和 图 6-14 所 示 。 其 中 ， 
图 6-13 是 重 写 onDraw 方法 的 效果 图 ， 可 以 看 到 中 间 的 按钮 遮 住 了 交叉 线 ， 图 6-14 是 重 写 
dispatchDraw 方法 的 效果 图 ， 可 以 看 到 交叉 线 没 被 按钮 庶 住 ， 依 然 显示 在 视图 中 央 。 

总 结 一 下 onLayout、onDraw、dispatchDraw 三 个 函数 的 区 别 : 


(1) onLayout 只 能 调整 子 视图 的 位 置 ， 而 onDraw 和 dispatchDraw 允许 绘制 新 图 形 。 

(2) onDraw 的 调用 在 绘制 子 视图 之 前 ， 而 dispatchDraw 的 调用 在 绘制 子 视图 之 后 。 

(3) onLayout 若 想 立即 显示 位 置 调整 后 的 视图 ， 则 要 调用 requestLayout 方法 ; onDraw 
和 dispatchDraw 若 想 立即 显示 图 形 绘制 后 的 视图 ， 则 要 调用 invalidate 方法 。 
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custom custom 














绘图 方式 : onDraw 画 叉 叉 bg 绘图 方式 : dispatchDraw 画 叉 叉 ” 
我 在 中 间 
图 6-13 重 写 onDraw 方法 图 6-14 重 写 dispatchDraw 方法 


6.2 自 定 义 动 画 


本 节 介绍 计时 器 的 实现 方式 和 如 何 利用 计时 器 实现 简单 的 下 拉动 画 ， 并 结合 自 定义 视图 
的 方法 实现 一 个 圆 弧 进度 动画 的 新 控件 。 


6.2.1 任务 Runnable 


在 前 面 的 章节 中 ， 有 几 个 需要 延迟 处 理 的 地 方 用 到 了 HandlertRunnable 组 合 ， 即 调用 
Handler 的 postDelayed 方法 延迟 若干 时 间 再 执行 指定 的 Runnable 任务 。 这 几 处 延迟 处 理 主要 
是 为 了 避免 资源 冲突 ， 不 过 延迟 处 理 更 多 用 于 动画 界面 的 泻 染 。 

Runnable 接口 可 声明 一 连 串 任务 ， 定 义 了 接 下 来 要 做 的 事情 。 简 单 地 说 ，Runnable 接口 
就 是 一 个 代码 片段 。 实 现 Runnable 接口 只 需 重 写 run 函数 ， 在 该 方法 内 部 存放 要 运行 的 任务 
代码 。run 函数 无 须 显 式 调用 ， 在 启动 Runnable 实例 时 就 会 调用 对 象 的 run 方法 。 

尽管 基本 视图 View 提供 了 post 与 postDelayed 方法 用 于 启动 Runnable 任务 , 不 过 实际 
发 中 经 常 利用 Handler 启动 任务 。 下 面 是 Handler 处 理 Runnable 任务 的 常见 方法 说 明 : 


post: 立即 启动 Runnable 任务 。 

postDelayed: 延迟 若干 时 间 后 启动 Runnable 任务 。 
postAtTime: 在 指定 时 间 启 动 Runnable 任务 。 
removeCallbacks: 移 除 指定 的 Runnable 任务 。 


计时 器 是 Runnable 的 一 个 简单 应 用 , 与 动画 的 实现 原理 相关 , 如 电影 每 秒 播放 20 帧 画面 ， 
连 起 来 就 是 会 动 的 视频 ， 动 画 的 泻 染 与 之 同 理 。 下 面 是 一 个 简单 计时 器 的 代码 片段 : 
public void onClick(View v) { 
if (v.getId() 一 R.id.btn_runnable) { 
f(!isStarted) { // 不 在 计数 ， 则 开始 计数 
btn_runnable.setText(" 停 止 计数 "); 
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/ 立即 启动 计数 任务 
mHandler.post(mCounter); 
} else { /W 已 在 计数 ， 则 停止 计数 
btn_runnable.setText(" 开 始 计数 "); 
/ 立即 取消 计数 任务 
mHandler.removeCallbacks(mCounter); 
} 
isStarted = lisStarted; 


有 


private boolean isStarted = false; / 是 否 开始 计数 
private HandlermHandler= new Handler0; / 声明 一 个 处 理 器 对 象 
private int mCount= 0; // 计数 值 
/ 定义 一 个 计数 任务 
private Runnable mCounter = new Runnable() { 
(QOverride 
public void run() { 
mCounttt; 
tv_result.setText(" 当 前 计数 值 为 : "+ mCount); 
/ 延迟 一 秒 后 重复 计数 任务 
mHandler.postDelayed(this, 1000); 


}» 
计时 器 的 效果 如 图 6-15 和 6-16 所 示 。 其 中 ， 图 6-15 表示 当前 正在 计数 ， 图 6-16 表示 当 
前 停止 计数 ， 终 止 的 计数 值 为 21。 


Custom 


Custom 


开始 计数 


当前 计数 值 为 : 21 





图 6-15 计时 器 开始 计数 图 6-16 计时 器 结束 计数 
6.2.2 下拉 刷 新 动画 


本 小 节 把 计时 器 引入 下 拉 刷 新 中 ， 每 隔 若 干 时 间 展 示 逐 步 加 大 的 视图 偏 移 ， 从 而 实现 下 
拉 刷 新 头 部 的 下 拉动 画 。 首 先 ， 计 算 下 拉 刷 新 头 部 的 高 度 ， 这 会 用 到 “6.1.3 测量 尺寸 ”的 知 
识 。 接 着 ， 计 时 器 每 隔 若干 时 间 为 padding 设置 逐步 加 大 的 高 度 偏 移 。 不 得 不 说 ，padding 大 
法 非常 好 用 ， 当 padding 为 负 值 时 ， 表 示 当 前 视图 被 庶 住 了 一 部 分 。 最 后 ， 高 度 的 偏 移 值 达 到 
头 部 布局 的 高 度 时 ， 停 止 Runnable 的 刷新 任务 ， 下 拉动 画 完 成 。 

下 面 是 下 拉 刷 新 动画 的 代码 片段 : 
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public void onClick(View v) { 
/ 计算 获取 线性 布局 的 实际 高 度 
int height = (int) MeasureUtil.getRealHeight(ll header); 
让 (v.getId0 一 Ridbtn_pulD { 

if(tisStarted){ / 不 在 刷新 ， 则 开始 下 拉 刷 新 
moOffset = -height; 
btn_pull.setEnabled(false); 

/ 立即 开始 下 拉 刷 新 任务 
mHandler.post(mRefresh); 

} else { /W 已 在 刷新 ， 则 停止 下 拉 刷 新 
btn_pull.setText(" 开 始 刷 新 "); 
ll_header.setVisibility(View.GONE); 

} 

isStarted = lisStarted; 


有 


private boolean isStarted = false; / 是 否 开始 刷新 
private Handler mHandler = new Handler(0); / 声明 一 个 处 理 器 对 象 
private int mOffset = 0; / 刷新 过 程 中 的 下 拉 偏 移 
/ 定义 一 个 下 拉 刷 新 任务 
private Runnable mRefresh = new Runnable() { 
(QOverride 
public void run() { 
让 (mOffset <= 0) { // 尚未 下 拉 到 位 
// 通过 设置 视图 上 方 的 间隔 ， 达 到 布局 缩 进 的 效果 
ll_header.setPadding(0, mOffset, 0, 0); 
ll_header.setVisibility(View.VISIBLE); 
mOffset += 8; 
/ 延迟 八 十 毫秒 后 重复 刷新 任务 
mHandler.postDelayed(this, 80); 
} else { // 已 经 下 拉 到 顶 了 
btn_pull.setText(" 恢 复 页 面 "); 
btn_pull.setEnabled(true); 


ta 
下 拉 刷 新 动画 的 效果 如 图 6-17 和 6-18 所 示 。 其 中 ， 图 6-17 展示 的 是 下 拉动 画 进行 中 的 
截图 ， 图 6-18 展示 的 是 下 拉 完 毕 的 截图 ， 此 时 下 拉 刷 新 头 部 完全 显示 。 
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Custom Custom 


小 、 轻 轻 下 拉 ,刷新 精彩 .… = 


Cr 
小 、 轻 轻 下 拉 ,刷新 精彩 
恢复 页 面 


开始 刷新 





图 6-17 下 拉动 画 开始 图 6-18 下 拉动 画 结束 
6.2.3” 圆 弧 进度 动画 


当 用 户 下 载 文件 或 做 其 他 事情 时 ， 往 往 想 知道 当前 到 什么 进度 了 。 在 Windows 系统 中 常 
用 细 长 的 进度 条 表示 , 在 手机 上 因为 屏幕 限制 ,习惯 展示 圆 形 或 弧 形 的 进度 圈 。 接 下 来 介绍 的 
就 是 圆 弧 进度 动画 ,该 动画 控件 正好 可 以 与 6.1 节 自 定义 视图 的 绘制 方法 结合 起 来 。 既 可 以 复 
习 旧 知识 ， 又 能 巩固 新 知识 。 

绘制 圆 弧 动画 的 主要 思路 是 在 一 段 指定 的 时 间 内 持续 不 断 地 绘制 一 个 扇形 或 圆 弧 ， 连 起 
来 整个 画面 就 会 动 起 来 。 还 要 进行 一 些 参数 设置 ， 如 设置 该 圆圈 的 位 置 、 开 始 和 结束 的 角度 、 
转动 的 速率 ， 以 及 画笔 的 颜色 、 粗 细 、 样 式 等 。 另外， 为 了 区 分 处 理 动画 的 背景 和 前 景 ， 还 要 
分 别 构造 背景 视图 (用 于 衬托 动画 ) 和 前 景 视图 (用 于 展示 圆 弧 〉。 

自 定义 圆 弧 动画 的 完整 代码 较 多 ， 限 于 篇 幅 就 不 贴 出 来 了 ， 读 者 可 参考 本 书 附带 源码 
custom 模块 的 CircleAnimation.java。 若 要 在 活动 页 面 中 显示 圆 弧 动画 ， 则 参见 以 下 页 面 代 码 : 

public class CircleAnimationActivity extends AppCompatActivity implements OnClickListener { 

private CircleAnimation mAnimation; / 定义 一 个 圆 弧 动画 对 象 








protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_circle_animation); 
findViewById(R.id.btn_play).setOnClickListener(this); 
LinearLayout ll_layout = findViewById(R.id.ll_layout); 
/ 创建 一 个 新 的 圆 弧 动画 
mAnimation = new CircleAnimation(this); 
// 把 圆 弧 动画 添加 到 线性 布局 1L_layout 之 中 
ll_layout.addView(mAnimation); 
// 泻 染 圆 弧 动画 。 演 染 操作 包括 初始 化 与 播放 两 个 动作 
mAnimation.render(); 

'; 


public void onClick(View v) { 
让 (v.getId0 一 R.id.btn_play) { 
/ 开始 播放 圆 弧 动画 
mAnimation.play(); 
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} 
圆 弧 动画 的 效果 如 图 6-19 和 6-20 所 示 。 其 中 ， 图 6-19 展示 的 是 圆 弧 动画 进行 中 的 截图 ， 
图 6-20 展示 的 圆 弧 动画 播放 完成 的 截图 。 
custom 
播放 圆 弧 动画 播放 圆 弧 动 画 
6-19 圆 弧 动画 开始 图 6-20 ” 圆 弧 动画 结束 











6.3” 自 定义 对 话 框 


本 节 介 绍 窗 口 与 对 话 框 的 基本 概念 和 使 用 方法 ， 并 利用 基础 对 话 框 实现 一 个 改进 的 日 期 
选择 对 话 框 , 结合 第 5 章 的 列表 视图 与 网 格 视 图 给 出 阶段 性 实战 小 项 目 一 一 多 级 对 话 框 的 实现 
效果 。 


6.3.1 ”对 话 框 Dialog 


App 界面 附着 在 窗口 Window 上 。 大 至 整个 活动 页 面 ， 小 至 Toast 的 提示 窗 ， 还 有 对 话 框 
Dialog， 都 建立 在 窗口 上 。 如 果 想 熟练 掌握 对 话 框 ， 就 必须 先 了 解 窗口 。 读 者 也 许 对 窗口 的 概 
念 不 甚 理解， 下面 从 Window 的 5 个 常用 方法 开始 介绍 。 

@ setContentView: 设置 内 容 视 图 。 这 个 方法 是 不 是 很 熟悉 ?我 们 每 天 打交道 的 Activity 
第 一 句 就 是 setContentView， 查 看 源码 后 发 现 内 部 原来 调用 了 同名 方法 getWindow(). 
setContentView. 
setLayout: 设置 内 容 视 图 的 宽 、 高 尺寸 。 
setGravity: 设置 内 容 视 图 的 对 齐 方 式 。 
setBackgroundDrawable: 设置 内 容 视图 的 背景 。 
findViewById: 根据 资源 ID 获取 该 视图 的 对 象 。 这 个 方法 每 个 Activity 代码 都 要 用 许 
多 遍 。 查 看 Activity 源码 后 可 以 发 现 该 方法 也 是 调用 Window 的 同名 方法 getWindow(). 
findViewByld. 
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原来 ,窗口 默默 地 做 了 许多 事情 ， 只 是 一 般 人 不 知道 嗣 了 。 熟悉 了 Window 的 概念 和 用 法 
后 ， 再 来 看 看 Dialog 的 工作 机 制 ， 在 屏幕 上 显示 对 话 框 主要 有 3 个 步骤 : 

C2T01 构造 一 个 对 话 框 对 象 并 指定 该 对 话 框 的 样式 。 

人 62 获取 该 对 话 框 依赖 的 窗口 对 象 ， 设 置 内 容 视图 并 指定 窗口 的 尺寸。 

人 03 完成 相关 属性 设置 ， 显 示 对 话 框 。 


下 面 来 看 具体 的 对 话 框 操作 方法 。 


e@ Dialog 构造 函数 : 可 定义 对 话 框 的 主题 样式 (样式 在 styles.xml 中 定义 ) ， 如 是 否 有 
标题 、 是 否 为 半 透 明 、 对 话 框 的 背景 是 什么 等 。 

e getWindow: 获取 对 话 框 的 窗口 对 象 。 该 方法 是 自 定义 对 话 框 的 关键 ， 首 先 获 取 对 话 

框 所 在 的 窗口 对 象 ， 然 后 往 这 个 窗口 添加 定制 视图 。 

show: 显示 对 话 框 。 

isShowing: 判断 对 话 框 是 否 显示 。 

hide: 隐藏 对 话 框 。 

dismiss: 关闭 对 话 框 。 

setCancelable: 设置 对 话 框 是 否 可 取消 。 

setCanceledOnTouchOutside: 点 击 对 话 框 外 部 区 域 是 否 自动 关闭 对 话 框 。 默 认 会 自动 

关闭 。 

esetOnShowListener: 设置 对 话 框 的 显示 监听 器 . 需 实现 OnShowListener 接口 的 onShow 
壳 法 、 

e@ setOnDismissListener: 设置 对 话 框 的 消失 监听 器 。 需 实现 OnDismissListener 接口 的 
onDismiss 方法 。 


6.3.2 ”改进 的 日 期 对 话 框 


对 话 框 常用 的 一 个 控件 是 提醒 对 话 框 AlertDialog， 还 有 第 5 章 介 绍 的 日 期 选择 对 话 框 
DatePickerDialog 和 时 间 选 择 对话 框 TimePickerDialog。 不 过 系统 自 带 的 对 话 框 往往 只 能 修改 
文字 , 无 法 调整 界面 布局 ， 也 无 法 定制 按钮 样式 ， 甚 至 连 文本 的 大 小 和 颜色 都 无 法 修改 。 并 且 
对 于 日 期 选择 对 话 框 来 说 ，Android 5.0 之 后 只 会 显示 日 历 格式 的 日 期 ， 不 会 显示 传统 风格 如 
图 6-21 所 示 的 日 期 。 

现在 利用 自 定义 的 对 话 框 ， 整 个 框 内 布局 都 是 允许 定制 的 ， 于 是 不 但 标题 、 按 钮 能 够 修 
改 样式 ， 而 且 中 间 的 日 期 选择 器 也 可 以 通过 属性 “android:datePickerMode="spinner"” 设 置 成 
传统 的 下 拉 框 风格 。 另 外 ,第 5 章 的 万 年 历 项 目 ， 当 时 因为 缺少 月 份 选择 对 话 框 ， 造 成 很 别扭 
地 在 页 面 上 硬 塞 下 月 份 选择 器 。 一 旦 实现 了 对 话 框 的 可 定制 修改 ， 那 么 采用 如 图 6-22 所 示 的 
月 份 选择 对 话 框 , 用 户 体验 的 优化 问题 即 可 迎刃而解 。 接 下 来 就 来 看 看 如 何 实现 自 定义 的 日 期 
对 话 框 和 月 份 对 话 框 ， 以 日 期 对 话 框 为 例 ， 具 体 的 改造 过 程 分 3 步 : 
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6-21 传统 风格 的 日 期 对 话 框 图 6-22” 自 定义 的 月 份 对 话 框 
CIO1 定义 一 个 对 话 框 布局 文件 ， 在 合适 的 地 方 放置 标题 文字 的 TextView 控件 、 选 择 日 期 
的 DatePicker 控件 ， 确 定 按钮 的 Button 控件 等 。 详 细 的 布局 文件 代码 如 下 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="(@color/transparent" 
android:gravity="center" 








android:orientation="vertical" 
android:paddingLeft="40dp" 
android:paddingRight="40dp" > 


<LinearLayout 
android:layout_width="wrap_content" 
android:layout_height="match_parent" 
android:orientation="vertical" 
android:background="(@color/white" > 


<TextView 
android:id="(@+id/tv_title" 
android:layout_width="match_parent" 
android:layout_height="60dp" 
android:paddingLeft="10dp" 
android:gravity="leftlcenter" 
android:text=" 请 选择 日 期 " 
android:textColor="(@color/blue" 
android:textSize="22sp" 亡 


<View 
android:layout_width="match_parent" 
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android:layout_height="2dp" 
android:background="(@color/blue" /> 


<!-- DatePicker 的 datePickerMode 设置 为 spinner 表示 采取 下 拉 框 风格 --> 
<DatePicker 
android:id="(@+id/dp_date" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:calendarViewShown="false" 
android:gravity="center" 
android:spinnersShown="true" 
android:datePickerMode="spinner" /> 


<View 
android:layout_width="match_parent" 
android:layout_height="1dp" 
android:background="(@color/blue" /> 


<Button 
android:id="(@+id/btn_ok" 
android:layout_width="match_parent" 
android:layout_height="60dp" 
android:background="(@null" 
android:gravity="center" 
android:text=" 确 定 " 
android:textColor="(@color/black" 
android:textSize="17sp" /> 
</LinearLayout> 
</LinearLayout> 


02 编写 自 定义 日 期 对 话 框 的 代码 ， 设 置 对 话 框 的 布局 、 样 式 、 日 期 、 标 题 ， 并 处 理 确 
定 按钮 的 点 击 事件 、 日 期 选择 器 的 变更 事件 等 。 自 定义 对 话 框 的 完整 代码 如 下 : 


public class CustomDateDialog implements OnClickListener { 
private Dialog dialog; / 声明 一 个 对 话 框 对 象 
Private View view; / 声明 一 个 视图 对 象 
private TextView tv_title; 
private DatePicker dp_date; / 声明 一 个 日 期 选择 器 对 象 





public CustomDateDialog(Context contexb { 
/ 根据 布局 文件 dialog_date xml 生成 视图 对 象 
view = LayoutInflater.from(context).inflate(R.layout.dialog_date, nulD; 
/ 创建 一 个 指定 风格 的 对 话 框 对 象 
dialog = new Dialog(context R.style.CustomDateDialog); 
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tv_title= view.findViewById(R.id.tv_title); 

/ 从 布局 文件 中 获取 名 叫 dp_date 的 日 期 选择 器 

dp_date = view.findViewById(R.id.dp date); 

View.findViewById(R.id.btn_ok).setOnClickListener(this); 
b 


// 设置 日 期 对 话 框 内 部 的 年 、 月 、 日 ， 以 及 日 期 变更 监听 器 

public void setDate(int year, int month, int day, OnDateSetListener listener) { 
dp_date.init(year, month, day, null); 
mDateSetListener = listener; 

}; 


// 显示 对 话 框 
public void showO { 
/ 设置 对 话 框 窗口 的 内 容 视图 
dialog.getWindow().setContentView(view); 
/ 设置 对 话 框 窗口 的 布局 参数 
dialog.getWindow().setLayout( 
LayoutParams.MATCH PARENT, LayoutParams.WRAP_ CONTENT); 
dialog.show(); / 显示 对 话 框 
小 


/ 关闭 对 话 框 
public void dismiss() { 
// 如 果 对 话 框 显 示 出 来 了 ， 就 关闭 它 
if (dialog != null && dialog.isShowingO) { 
dialog.dismiss(); 
} 
} 


@Override 
public void onClick(View v) { 
让 (v.getId0 一 R.id.btn_ok) { // 点 击 了 确定 按钮 
dismiss0; / 关闭 对 话 框 
if(mDateSetListener != null) { // 如 果 存 在 月 份 变更 监听 器 
dp_date.clearFocus(); // 清除 日 期 选择 器 的 焦点 
// 回调 监听 器 的 onDateSet 方法 
mDateSetListener.onDateSet(dp_date.getYear(), 
dp_date.getMonth() + 1, dp_date.getDayOf Month()); 
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// 声明 一 个 日 期 变更 的 监听 器 对 象 
private OnDateSetListener mDateSetListener; 
// 定义 一 个 日 期 变更 的 监听 器 接口 
public interface OnDateSetListener { 
void onDateSet(int year, int monthOf Year, int dayOfMonth); 
上 
} 
703 在 Acitvity 页 面 中 使 用 自 定义 的 日 期 对 话 框 ， 调 用 代码 举例 如 下 
// 显示 自 定义 的 日 期 对 话 框 
private void showDateDialog() { 
Calendar calendar = Calendar.getInstance(); 
/ 创建 一 个 自 定义 的 日 期 对 话 框 实例 
CustomDateDialog dialog = new CustomDateDialog(this); 
/ 设置 日 期 对 话 框 上 面 的 年 、 月 、 日 ， 并 指定 日 期 变更 监听 器 
dialog.setDate(calendar.get(Calendar. YEAR), calendar.get(Calendar.MONTH), 
calendarget(CalendarDAY_ OF MONTH), new DateListener()); 
dialog.show(); // 显示 日 期 对 话 框 
) 


// 定义 一 个 日 期 变更 监听 器 ， 一 旦 点 击 对 话 框 的 确定 按钮 ， 就 触发 监听 器 的 onDateSet 方法 
private class DateListener implements OnDateSetListener { 
@Override 
public void onDateSet(int year, int month, int day) { 
String desc = String.format(" 您 选择 的 日 期 是 %d 年 %d 月 %d 日 ", year, month, day); 
tv_date.setText(desc); 


} 
6.3.3” 自 定义 多 级 对 话 框 


在 实际 开发 中 ， 自 定义 对 话 框 往往 比较 复杂 ， 比 如 对 话 框 不 在 屏幕 中 央 而 在 屏幕 下 方 、 
对 话 框 在 消失 前 还 需 做 其 他 处 理 、 对 话 框 像 多 级 菜单 一 样 需 要 分 级 展示 等 。 

如 图 6-23 与 图 6-24 所 示 ， 选 择 对 话 框 分 两 级 显示 。 图 6-23 展示 的 是 好 友 列 表 ， 用 到 了 
列表 视图 ListView; 图 6-24 展示 的 是 好 友 关 系 ， 用 到 了 网 格 视图 GridView， 二 级 对 话 框 位 于 

-级 对 话 框 之 上 。 

这 个 多 级 对 话 框 是 一 个 阶段 性 的 实战 小 项 目 ， 不 但 运用 了 自 定 义 对 话 框 的 进 阶 实现 ， 而 
且 使 用 了 第 5 章 介 绍 的 列表 视图 与 网 格 视图 , 有 兴趣 的 读者 可 尝试 将 其 编码 实现 。 完整 的 多 级 
对 话 框 代码 参见 本 书 附带 源码 custom 模块 的 DialogFriend.java 和 DialogFriendRelation.java。 
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本 人 哥哥 
您 将 添加 以 下 号 码 为 好 友 姐姐 妹妹 表 哥 表 弟 表姐 
关系 手机 号 码 允许 访问 朋友 图 操作 表妹 报 报 巡 群 姑妈 姑父 
坡 所 15960238696 @ 允许 〇 禁止 。 弄 除 郧 郧 郧 妈 阿姨 姨 夫 朋友 
表 哥 15805910591 @ 允许 〇 禁止 开除 其 他 15805910591 @ 允许 〇 禁止 俐 除 
朋友 18905710571 @ 允许 〇 禁止 副 除 其 他 18905710571 @ 允许 〇 禁止 删除 
确定 确定 
图 6-23 第 一 级 对 话 框 图 6-24 第 二 级 对 话 框 


6.4” 自 定义 通知 栏 


本 节 介 绍 通知 栏 的 用 法 和 如 何 自 定义 通知 栏 ， 包 括 通知 推送 Notification 的 设置 、 进 度 条 
ProgressBar 的 样式 定制 、 远 程 视图 RemoteViews 的 配置 方法 ， 并 给 出 一 个 自 定义 通知 栏 的 具 
体例 子 ， 以 及 通知 文本 的 颜色 设 定 。 


6.4.1 


通知 推送 Notification 


在 手机 屏幕 的 顶端 下 拉 会 弹出 通知 栏 ， 里 面 存放 的 是 App 即时 提醒 用 户 的 消息 ， 消 息 内 
容 由 Notification 产生 并 推送 。 每 条 消息 通知 基本 都 有 图 标 、 标 题 、 内 容 、 时 间 等 元 素 ， 参 数 
通过 Notification.Builder 构建 。 下 面 来 看 常用 的 参数 构建 方法 。 


e@ setWhen: 设置 推送 时 间 ， 格 式 为 “小 时 : 分 钟 ”。 推 送 时 间 在 通知 栏 右 方 显示 。 
e@ setShowWhen: 设置 是 否 显示 推送 时 间 。 


setUsesChronometer: 设置 是 否 显示 计数 器 。 为 true 时 不 显示 推送 时 间 , 动态 显示 从 通 
知 被 推送 到 当前 的 时 间 间 隔 ， 以 “分 钟 : 秒 钟 ”格式 显示 。 

setSmallIcon: 设置 状态 栏 里 面 的 图 标 (小 图 标 ) 。 

setTicker: 设置 状态 栏 里 面 的 提示 文本 。 

setLargeIcon: 设置 通知 栏 里 面 的 图 标 ( 大 图 标 ) 。 

setContentTitle: 设置 通知 栏 里 面 的 标题 文本 。 

setContentText: 设置 通知 栏 里 面 的 内 容 文本 。 

setSubText: 设置 通知 栏 里 面 的 附加 说 明文 本 ， 位 于 内 容 文本 下 方 。 若 调用 该 方法 ， 
则 setProgress 的 设置 失效 。 

setProgress: 设置 进度 条 与 当前 进度 。 进 度 条 位 于 标题 文本 与 内 容 文本 中 间 。 


e@ setNumber: 设置 通知 栏 右 下 方 的 数字 ， 可 与 setProgress 联合 使 用 ， 表 示 当 前 的 进度 数 


值 。 
setContentInfo: 设置 通知 栏 右 下 方 的 文本 。 若 调用 该 方法 ， 则 setNumber 的 设置 失效 。 
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e@ ”setContentIntent: 设置 内 容 的 延迟 意图 PendingIntent， 点 击 该 通知 时 触发 该 意图 。 通常 
调用 PendingIntent 的 getActivity 方法 获得 延迟 意图 对 象 ，getActivity 表示 点 击 后 跳 转 
到 该 页 面 。 

e@ setDeleteIntent: 设置 删除 的 延迟 意图 PendingIntent， 滑 掉 该 通知 时 触发 该 动作 。 

e@ setAutoCancel: 设置 该 通知 是 否 自动 清除 。 若 为 true， 则 点 击 该 通知 后 ， 通 知 会 自动 
消失 ; 若 为 人 alse， 则 点 击 该 通知 后 ， 通 知 不 会 消失 。 

@ setContent: 设置 一 个 定制 的 通知 栏 视图 RemoteViews， 用 于 取代 Builder 的 默认 视图 模 
板 。 

日 build: 构建 方法 。 在 以 上 参数 都 设置 完毕 后 ， 调 用 该 方法 返回 Notification 对 象 。 





(1) setSmalllcon 方法 必须 调用 ， 和 否则 不 会 显示 通知 消息 。 

(2) setWhen 与 setUsesChronometer 同时 只 能 调用 其 中 一 个 ， 即 推送 时 间 与 计数 器 无 法 
同时 显示 ， 因 为 它们 都 位 于 通知 栏 右 边 。 

(3) setSubText 与 setProgress 同时 只 能 调用 其 中 一 个 ， 因 为 附加 说 明 与 进度 条 都 位 于 标 
题 文本 下 方 。 

(4) setNumber 与 setContentInfo 同时 只 能 调用 其 中 一 个 ， 因 为 计数 值 与 提示 都 位 于 通知 
栏 右 下 方 。 

使 用 Notification 只 能 生成 通知 内 容 ， 实 际 推送 动作 还 需 借助 系统 的 通知 服务 实现 。 
NotificationManager 是 系统 通知 服务 的 管理 类 ， 有 以 下 3 个 常用 方法 。 


e@ notify: 推送 指定 消息 到 通知 栏 。 
e@ cancel: 取消 指定 消息 。 调 用 该 方法 后 ， 通 知 栏 中 的 指定 消息 将 消失 。 
e@ cancelAll: 取消 所 有 消息 。 


下 面 是 发 送 简单 消息 的 代码 片段 : 


/ 发 送 简 单 的 通知 消息 (包括 消息 标题 和 消息 内 容 ) 
private void sendSimpleNotify(String title, String message) { 
/ 创建 一 个 跳 转 到 活动 页 面 的 意图 
Intent clickIntent = new Intent(this, MainActivity.class); 
// 创建 一 个 用 于 页 面 跳 转 的 延迟 意图 
PendingIntent contentIntent = PendingIntent.getActivity(this, 
R.string.app_name, clickIntent, PendingIntent.FLAG UPDATE CURRENT); 
// 创建 一 个 通知 消息 的 构造 器 
Notification.Builder builder = new Notification.Builder(this): 
builder.setContentIntent(contentIntent) // 设置 内 容 的 点 击 意图 
.setAutoCancel(true) / 设置 是 否 允 许 自动 清除 
.setSmallIcon(R_.drawable.ic_app) / 设置 状态 栏 里 的 小 图 标 
.setTicker(" 提 示 消 息 来 啦 ") / 设置 状态 栏 里 面 的 提示 文本 
.setWhen(System.currentTimeMillis()) / 设置 推送 时 间 ， 格 式 为 “小 时 : 分 钟 ” 
/ 设置 通知 栏 里 面 的 大 图 标 
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.setLargelcon(BitmapFactory.decodeResource(getResources(), R.drawable.ic_ app)) 
.setContentTitle(title) / 设置 通知 栏 里 面 的 标题 文本 
.SetContentText(message); // 设置 通知 栏 里 面 的 内 容 文 本 

/ 根据 消息 构造 器 构建 一 个 通知 对 象 

Notification notify = builder.build(); 

/ 从 系统 服务 中 获取 通知 管理 器 

NotificationManager notifyMgr= (Notification Manager) 
getSystemService(ContexLtNOTIFICATION _ SERVICE); 

/ 使 用 通知 管理 器 推送 通知 ， 然 后 在 手机 的 通知 栏 就 会 看 到 该 消息 

notifyMgrnotify(R.string.app_name, notify); 

| 


简单 消息 的 通知 栏 效果 如 图 6-25 所 示 ， 左 边 是 图 标 ， 中 间 是 标题 与 内 容 ， 右 边 是 时 间 。 





图 6-25 简单 消息 的 通知 栏 效果 


下 面 是 发 送 计 时 消息 的 代码 片段 : 
/ 发 送 计 时 的 通知 消息 通知 栏 右边 自动 计时 》 
private void sendCounterNotify(String title, String message) { 

// 创建 一 个 跳 转 到 活动 页 面 的 意图 

Intent cancelIntent = new Intent(this, MainActivity.class); 

/ 创建 一 个 用 于 页 面 跳 转 的 延迟 意图 

PendingJntent deleteIntent = PendingIntent.getActivity(this, 
R.string.app_name, cancelIntent PendingIntentFLAG_UPDATE_ CURRENT); 

/ 创建 一 个 通知 消息 的 构造 器 

Notification.Builder builder = new Notification.Builder(this); 

builder.setDeleteIntent(deleteIntent) // 设置 内 容 的 清除 意图 
.setAutoCancel(true) // 设置 是 否 允 许 自 动 清除 
.SetUsesChronometer(true) // 设置 是 否 显示 计数 器 
.setProgress(100, 60, false) // 设置 进度 条 与 当前 进度 
-setNumber(99) / 设置 通知 栏 右 下 方 的 数字 
.setSmallIcon(R.drawable.ic_app) / 设置 状态 栏 里 的 小 图 标 
-setTicker(" 提 示 消息 来 啦 ") // 设置 状态 栏 里 面 的 提示 文本 
// 设置 通知 栏 里 面 的 大 图 标 
.setLargelcon(BitmapFactory.decodeResource(getResources(), R.drawable.ic_app)) 
.setContentTitle(title) / 设置 通知 栏 里 面 的 标题 文本 
.SetContentText(message); / 设置 通知 栏 里 面 的 内 容 文 本 

/ 根据 消息 构造 器 构建 一 个 通知 对 象 

Notification notify = builder.build(); 

/ 从 系统 服务 中 获取 通知 管理 器 
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Notification Manager notifyMgr= (NotificationManager) 
getSystemService(ContextNOTIFICATION_ SERVICE); 
/ 使 用 通知 管理 器 推送 通知 ， 然 后 在 手机 的 通知 栏 就 会 看 到 该 消息 
notifyMgrnotify(R.string.app_name, notify); 
计时 消息 的 通知 栏 效果 如 图 6-26 所 示 ， 通 知 栏 左边 是 图 标 ， 中 间 是 标题 文本 、 进 度 条 和 
内 容 文本 ， 右 边 是 计时 器 与 计数 值 。 


hl 


图 6-26 计时 消息 的 通知 栏 效果 


上 面 消 息 推送 的 两 段 代码 在 Android 7.1 和 以 前 版 本 的 系统 上 都 运行 正常 ， 然 而 到 了 

de ee 这 是 因为 Android 从 8.0 开始 进一步 规范 了 通知 栏 的 合理 使 
,要求 每 条 通知 都 区 分 它 的 重要 性 程度 , 或 者 说 是 划分 通知 渠道 , 好 比 高 速 公路 上 的 慢车 道 、 

ey 紧急 通道 等 等 。 有 了 通知 渠道 之 后 ， 用 户 就 能 单独 开关 应 用 内 部 某 个 渠道 的 通知 ， 
而 实现 更 加 精细 化 的 通知 栏 管理 。 例 如 只 开启 重要 的 提醒 通知 ,同时 关闭 扰 人 的 促销 消息 ， 
样 能 够 有 效 地 净化 系统 通知 栏 。 

具体 到 编码 上 ， 则 需 根 据 渠道 编号 创建 一 个 通知 渠道 NotificationChannel 的 实例 ， 并 通过 
通知 管理 器 对 象 的 createNotificationChannel 方法 创建 该 渠道 ， 相 应 的 代码 举例 如 下 : 


@TargetApi(Build.VERSION_CODES.O) 
// 创建 通知 渠道 。Android 8.0 开始 必须 给 每 个 通知 分 配对 应 的 渠道 
public static void createNotifyChannel(Context ctx, String channelld) { 
/ 创建 一 个 默认 重要 性 的 通知 渠道 
NotificationChannel channel = new NotificationChannel(channelld, 
"Channel", NotificationManagerIMPORTANCE_DEFAULT); 
channel.setSound(null, nulD); / 设置 推送 通知 之 时 的 铃声 。null 表示 静音 推送 
channel.enableLights(true); / 设置 在 桌面 图 标 右上 角 展 示 小 红 点 
channel.setLightColor(Color RED); / 设置 小 红 点 的 颜色 
channel.setShowBadge(true); // 在 长 按 桌 面 图 标 时 显示 该 渠道 的 通知 
/ 从 系统 服务 中 获取 通知 管理 器 
NotificationManager notifyMgr = (NotificationManager) 
ctx.getSystemService(ContextNOTIFICATION_SERVICE); 
/ 创建 指定 的 通知 渠道 
notifyMegr.createNotificationChannel(channel); 





} 
创建 好 了 通知 渠道 ， 接 下 来 还 得 给 每 条 通知 分 配对 应 的 渠道 。 此 时 需要 适 配 不 同 版 本 的 
Android 系统 ， 对 于 Android 7.1 及 以 前 版 本 ,仍然 调用 Notification.Builder 只 有 一 个 参数 的 构 
造 函 数 ; 但 是 对 于 Android 8.0 及 以 后 版 本 , 就 要 调用 Notification.Builder 带 两 个 参数 的 构造 函 
数 ， 其 中 第 二 个 参数 正 是 之 前 创建 渠道 用 到 的 渠道 编号 channelld。 适 配 后 的 代码 如 下 : 
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/ 创建 一 个 通知 消息 的 构造 器 
Notification.Builder builder = new Notification.Builder(this); 
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { 
// Android 8.0 开始 必须 给 每 个 通知 分 配对 应 的 渠道 
builder = new Notification.Builder(this, getString(R.string.app_name)); 
} 


站 充 以 上 两 处 代码 之 后 ， 通 知 管理 器 也 能 在 Android 8.0 系统 上 正常 推送 消息 了 。 
进度 条 ProgressBar 


消息 通知 Notification 的 setProgress 方法 是 对 内 置 进度 条 进行 操作 ， 不 过 很 多 时 候 进 度 条 
会 单独 使 用 ， 有 必要 了 解 一 下 ProgressBar 的 具体 用 法 。 
下 面 来 看 进度 条 的 常用 属性 。 


style: 指定 进度 条 的 形状 样式 。?android:attr/progressBarStyleHorizontal 表示 水 平 形 
状 ，?android:attr/progressBarStyle 表示 圆圈 形状 。 


。 max: 指定 进度 条 的 最 大 值 。 
e@ progress: 指定 进度 条 当前 进度 值 。 
日 secondaryProgress: 指定 进度 条 当前 次 要 进度 值 。 比 如 播放 视频 ，progress 用 来 表示 当 


前 播放 进度 ，secondaryProgress 用 来 表示 当前 缓冲 进度 。 
progressDrawable: 指定 进度 条 的 进度 图 形 。 


进度 条 的 常用 方法 有 以 下 9 个 。 


setProgress: 设置 当前 进度 。 

getProgress: 获取 当前 进度 。 

setSecondaryProgress: 设置 次 要 进度 。 
getSecondaryProgress: 获取 次 要 进度 。 

setMax: 设置 进度 条 的 最 大 值 。 

getMax: 获取 进度 条 的 最 大 值 。 

incrementProgressBy: 设置 当前 进度 的 增 量 。 
incrementSecondaryProgressBy: 设置 次 要 进度 的 增 量 。 
setProgressDrawable: 设置 进度 条 的 进度 图 形 。 


使 用 进度 条 时 需要 注意 以 下 两 点 : 


(1) max、progress 的 相关 属性 和 方法 只 在 样式 为 progressBarStyleHorizontal 时 才 有 效 ， 


即 水 平 进度 条 可 动态 设置 进度 值 ， 如 果 样 式 为 progressBarStyle 圆圈 形状 ， 最 大 值 与 进度 值 的 
设置 就 会 失效 , 即 圆圈 形状 不 会 显示 当前 进度 , 只 会 元 自 旋转 。 想 实现 动态 显示 进度 的 进度 条 ， 
可 参考 6.2 节 的 圆 弧 进度 动画 。 


(2) progressDrawable 进度 图 形 不 能 用 普通 图 形 ， 只 能 用 层次 图 形 LayerDrawable。 层 次 


图 形 可 在 XML 文件 中 定义 ， 如 果 用 于 描述 进度 图 形 就 要 同时 定义 两 个 层次 ， 即 背景 层次 与 进 


度 条 层次 。 例 如 ,在 自 定义 圆 弧 动画 时 运用 了 背景 视图 与 前 景 视图 ， 在 进度 条 中 就 存在 背景 层 
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次 ， 只 不 过 前 景 视 图 换 成 了 进度 条 层次 。 


下 面 是 一 个 层次 图 形 定义 的 XML 例子 。 其 中 ， 根 节点 layer-list 表示 这 是 一 个 层次 列表 ， 
即 层 次 图 形 定义 ; 背景 层次 的 id 为 @android:id/background， 采 用 的 是 形状 图 形 〈 节 点 名 称 为 
shape) ; 进度 条 层次 的 id 为 @android:id/progress， 采 用 的 是 裁剪 图 形 ClipDrawable 〈 节 点 名 
称 为 clip) : 
<!-- 层次 图 形 定义 --> 
<layer-list xmlIns:android="http://schemas.android.com/apk/res/android" > 
<!-- 这 是 背景 图 层 ， 里 面 定义 了 一 个 shape 形状 图 形 -> 
<item android:id="(@android:id/background"> 
<shape> 
<solid android:color="#333333" 亡 
</shape> 


</item> 


<!-- 这 是 进度 条 图 层 ， 里 面 定义 了 一 个 clip 裁剪 图 形 --> 
<item android:id="(@android:id/progress"> 
<clip> 
<nine-patch android:src="(@drawable/notify_green" /> 
</clip> 
</item> 
</layer-list> 
下 面 是 进度 条 控件 在 布局 文件 中 使 用 的 XML 代码 片段 : 
<!-- 这 是 水 平 进度 条 ， 其 中 progressDrawable 属性 指定 了 进度 条 的 图 形 模样 --> 
<ProgressBar 
android:id="@+id/pb_progress" 
style="?android:attr/progressBarStyleHorizontal" 
android:layout_width="match_parent" 
android:layout_height="30dp" 
android:background="(@color/black" 
android:max="100" 
android:progress="0" 
android:progressDrawable="(@drawable/notify_progress_green" > 


进度 条 设置 前 后 的 效果 如 图 6-27 与 图 6-28 所 示 。 其 中 ， 图 6-27 所 示 为 进度 值 为 0 的 界 
面 ， 此 时 只 有 一 条 黑色 的 进度 条 背景 ， 图 6-28 所 示 为 进度 值 为 40 的 界面 ， 此 时 绿色 进度 条 占 
据 全 部 进度 长 度 的 40% 。 
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40 


情 输 入 两 位 进度 什 





显示 进度 条 显示 进度 条 


图 6-27 进度 值 为 0 的 进度 条 图 6-28 进度 值 为 40 的 进度 条 
6.4.3 ”远程 视图 RemoteViews 


前 面 介绍 Notification 的 常用 方法 时 提 到 setContent 方法 可 以 在 设置 定制 的 通知 栏 视图 
RemoteViews 时 取代 Builder 的 默认 视图 模板 。 这 表示 通知 栏 允许 自 定 义 ， 并 且 自 定义 通知 栏 
需要 采用 远程 视图 RemoteViews。 

与 活动 页 面相 比 ， 如 果 说 对 话 框 是 一 个 小 型 页 面 ， 远 程 视图 就 是 一 个 小 型 且 简 化 的 页 面 。 
简化 的 意思 是 功能 减少 了 ,限制 变 多 了 。 虽 然 RemoteViews 与 Activity 一 样 有 自己 的 布局 文件 ， 
但 是 RemoteViews 的 使 用 权限 小 了 很 多 。 两 者 的 区 别 主 要 有 : 


(1) RemoteViews 主要 用 于 通知 栏 部 件 和 桌面 部 件 ， 而 Activity 用 于 页 面 。 

(2) RemoteViews 只 支持 少数 几 种 控件 , 如 TextView、ImageView、Button、ImageButton、 
ProgressBar、Chronometer 〈 计 时 器 ) 和 AnalogClock〈 模 拟 时 钟 ) 。 

(3) RemoteViews 不 可 直接 获取 和 设置 控件 信息 ， 只 能 通过 该 对 象 的 set 方法 修改 控件 
信息 。 

下 面 来 看 远程 视图 的 常用 方法 。 

e 构造 函数 : 创建 一 个 RemoteViews 对 象 。 第 一 个 参数 是 包 名 ， 第 二 个 参数 是 布局 文件 

id。 
setViewVisibility: 设置 指定 控件 是 否 可 见 。 
setViewPadding: 设置 指定 控件 的 间距 。 
setTextViewText: 设置 指定 TextView 或 Button 控件 的 文字 内 容 。 
setTextViewTextSize: 设置 指定 TextView 或 Button 控件 的 文字 大 小 。 
setTextColor: 设置 指定 TextView 或 Button 控件 的 文字 颜色 。 
setTextViewCompoundDrawables: 设置 指定 TextView 或 Button 控件 的 文字 周围 图 标 。 
setImageViewResource: 设置 ImageView 或 ImgaeButton 控件 的 资源 编号 。 
setImageViewBitmap: 设置 ImageView 或 ImgaeButton 控件 的 位 图 对 象 。 
setChronometer: 设置 计时 器 信息 。 
setProgressBar: 设置 进度 条 信息 ， 包 括 最 大 值 与 当前 进度 。 
setOnClickPendingIntent: 设置 指定 控件 的 点 击 响应 动作 。 


完成 RemoteViews 对 象 的 构建 与 设置 后 调用 Notification 对 象 的 setContent 方法 ， 即 可 完成 自 
定义 通知 的 定义 。 下 面 是 一 个 远程 视图 用 到 的 布局 文件 代码 ( 仿 干 千 静 听 )》: 


© 0 0 0 ee ee ee ea ee@ 9。 





<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
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android:layout_width="match parent" 
android:layout_height="match parent" 
android:minHeight="64dp" 
android:orientation="horizontal" > 


<!-- 这 是 通知 栏 左 侧 的 图 标 ， 仿 千 千 静 昕 -> 
<ImageView 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="1" 
android:scaleType="fitCenter" 
android:src="(@drawable/tt" /> 


<LinearLayout 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="4" 
android:layout_margin="3dp" 
android:orientation="vertical" > 


<!-- 这 是 展示 歌曲 播放 进度 的 进度 条 一 > 
<ProgressBar 
android:id="(@+id/pb_play" 
style="?android:attr/progressBarStyleHorizontal" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="1" 
android:max="100" 
android:progress="10" /> 


<!-- 这 是 正在 播放 的 歌曲 名 称 -> 

<TextView 
android:id="(@+id/tv_play" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="1" 
style="(@style/NotificationTitle" 
android:textSize="17sp" /> 

</LinearLayout> 


<LinearLayout 
android:layout_width="0dp" 
android:layout_height="match_parent" 
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android:layout weight= "1" 
android:orientation="vertical" > 


<!-- 这 是 计数 器 ， 用 于 显示 歌曲 已 经 播放 的 时 长 --> 

<Chronometer 
android:id="(@+id/chr_play" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="2" 
android:gravity="center" 
style="(@style/NotificationTitle" /> 


<!- 这 是 控制 按钮 ， 用 于 歌曲 的 暂停 与 恢复 操作 --> 

<Button 
android:id="(@+id/btn_play" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="3" 
android:gravity="center" 
android:background="(@drawable/btn_nine_selector" 
android:text=" 暂 停 " 
android:textColor="(@color/black" 
android:textSize="15sp" /> 


</LinearLayout> 
</LinearLayout> 


下 面 是 获取 自 定义 通知 对 象 的 代码 例子 : 


private Notification getNotify(Context ctx, String event, String song, boolean isPlaying, int progress, 


long time) { 


/ 创建 一 个 广播 事件 的 意图 
Intent intent] = new Intent(event); 
/ 创建 一 个 用 于 广播 的 延迟 意图 
PendingIntent broadIntent = PendingIntent.getBroadcast( 
ctx, R.string.app_name, intentl, PendingIntent.FLAG UPDATE CURRENT); 
/ 根据 布局 文件 notify_music.xml 生成 远程 视图 对 象 
RemoteViews notify_ music = new RemoteViews(ctx.getPackageName(), R.layout.notify music); 
让 (isPlaying) { / 正在 播放 
notify_music.setTextViewText(R.id.btn_play, "暂停 "); / 设置 按钮 文字 
notify_music.setTextViewText(R.id.tv_play, song + "正在 播放 "); / 设置 文本 文字 
notify_music.setChronometer(R.id.chr_play, time, "%s", true); / 设置 计数 器 
}else { // 不 在 播放 
notify_music.setTextViewText(R.id.btn_play, "继续 "); / 设置 按钮 文字 
notify_music.setTextViewText(R.id.tv_play, song + "暂停 播放 "); / 设置 文本 文字 
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自 定义 通知 栏 的 效果 如 图 6-29 所 示 , 可 以 看 到 播放 器 图 标 在 通知 栏 左边 ,进度 条 在 上 方 ， 
名 称 在 下 方 ， 计 时 器 与 控制 按钮 分 布 在 通知 栏 右边 。 


企 北京 欢迎 你 正在 播放 


notify_music.setChronometer(R.id.chr play, time, "%s", false); // 设置 计数 器 
!; 
/ 设置 远程 视图 内 部 的 进度 条 属性 
notify music.setProgressBar(R.id.pb_play, 100, progress, false); 
/ 整个 通知 已 经 有 点 击 意图 了 ， 那 要 如 何 给 单个 控件 添加 点 击 事件 ? 
/ 办 法 是 设置 控件 点 击 的 广播 意图 ， 一 旦 点 击 该 控件 ， 就 发 出 对 应 事件 的 广播 。 
notify music.setOnClickPendingIntent(R.id.btn_play, broadIntent); 
/ 创建 一 个 跳 转 到 活动 页 面 的 意图 
Intent intent2 = new Intent(ctx, MainActivity.class); 
/ 创建 一 个 用 于 页 面 跳 转 的 延迟 意 
PendingIntent clickIntent = PendingIntent.getActivity(ctx, 
R.string.app_name, intent2, PendingIntentFLAG_UPDATE_ CURRENT); 
/ 创建 一 个 通知 消息 的 构造 器 
Notification.Builder builder = new Notification.Builder(ctx); 
让 (Build.VERSION.SDK_ INT >= Build.VERSION_ CODES.O) { 
/Android 8.0 开始 必须 给 每 个 通知 分 配对 应 的 渠道 
builder = new Notification.Builder(ctx getString(R.string.app_name)); 
} 
builder.setContentIntent(clickIntent) // 设置 内 容 的 点 击 意图 
.SetContent(notify music) / 设置 内 容 视图 
.setTicker(song) // 设置 状态 栏 里 面 的 提示 文本 
.SetSmallIcon(R.drawable.tt_s); / 设置 状态 栏 里 的 小 图 标 
/ 根据 消息 构造 器 构建 一 个 通知 对 象 
Notification notify = builder.build(); 
return notify; 





图 6-29 ” 自 定义 通知 栏 的 效果 图 


6.4.4” 自 定义 通知 的 文本 颜色 设 定 




















上 一 小 节 利 用 RemoteViews 实现 了 通知 消息 的 个 性 化 定制 ， 对 于 消息 标题 的 文本 颜色 ， 
发 者 习惯 设置 为 白色 ， 因 为 系统 通知 栏 的 背景 是 黑色 嘛 。 然 而 现在 很 多 手机 厂商 都 会 修改 


Android 系统 的 底层 源码 ， 使 之 具备 该 厂家 宣传 的 风格 特征 。 比 如 部 分 小 米 手机 就 把 通知 栏 的 
改 成 白色 , 此 时 开发 者 若 将 自 定义 通知 的 标题 设 为 白色 , 毫 无 疑问 在 白色 背景 中 看 不 到 白 
色 文 字 。 要 是 将 自 定义 通知 的 标题 设 为 黑色 , 在 采取 黑色 背景 通知 栏 的 众多 手机 那 边 ， 


背景 
上 月 泵 


乎 乎 一 团 般 的 抓 瞎 。 




















更 糟糕 的 是 ， 开 发 者 根本 无 法 辨别 哪些 手机 改 了 通知 栏 的 背景 ， 甚 至 都 无 从 获知 


也 是 黑 


背景 色 
背景 色 
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是 什么 , 也 就 没 法 在 代码 里 面 判 断 并 处 理 。 幸 好 Android 在 系统 的 资源 文件 中 配置 了 统一 风格 ， 
像 通知 栏 标题 颜色 ， 其 实 是 从 系统 资源 文件 获取 对 应 的 色 值 。 对 Android4.* 系 统 来 说 , 通知 栏 
的 标题 色 取 自 系统 的 “?android:attr/textColorPrimary”; 对 于 Android5.0 及 以 上 的 系统 ， 通 知 
标题 的 文字 风格 android:textAppearance 取 自 系统 的 “@android:style/TextAppearance.Material. 
Notification.Title”。 这 样 一 来 ， 在 自 定义 通知 的 时 候 ， 开 发 者 可 以 将 标题 文字 颜色 设置 为 系统 
默认 的 标题 色 。 于 是 系统 通知 拥有 什么 文本 颜色 (可 能 是 黑 底 白字 也 可 能 是 白 底 黑 字 ) ， 开 发 
者 自 定义 的 通知 也 是 什么 文本 颜色 , 从 而 一 劳 永 锡 解决 了 通知 栏 的 标题 颜色 与 背景 颜色 的 适 配 
问题 。 
具体 到 App 开发 的 适 配 工 作 上 面 ， 则 需 进 行 以 下 操作 步骤 : 
(1) 首先 打开 res\values 目录 下 面 的 styles.xml， 在 resources 节点 内 部 添加 如 下 所 示 的 风 

格 配置 ， 表 示 定 义 一 个 采取 系统 默认 标题 色 的 字体 风格 : 

<style name="NotificationTitle"> 

<item name="android:textColor">?android:attr/textColorPrimary</item> 
</style> 


(2) 其 次 在 res 目录 下 新 建 一 个 文件 夹 values-v21， 再 在 该 文件 夹 下 新 建 一 个 styles.xml， 
并 往 该 XML 文件 填 入 下 列 的 风格 配置 代码 : 
<resources xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- Android5.0 之 后 使 用 新 的 通知 栏 标题 风格 定义 --> 
<style name="NotificationTitle"> 
<item 
name="android:textAppearance">(@android:style/TextAppearance.Material.Notification. Title</item> 
</style> 
</resources> 


新 文件 夹 values-v21 用 于 适 配 版 本 代码 不 低 于 21 的 Android 系统 ， 即 Android5.0 及 更 高 
版 本 的 系统 。 俏 若 当前 手机 运行 的 是 Android4.*， 则 App 运行 的 时 候 ， 系 统 会 自动 到 values 
目录 下 寻找 相应 的 资源 配置 ， 倘 若 当 前 手机 运行 的 是 Android5.0 或 者 更 高 版 本 ， 则 系统 会 优 
先 在 values-v21 目录 下 查找 资源 ， 有 找到 就 用 这 里 的 资源 ， 没 找到 再 用 values 目录 下 的 资源 。 

(3) 最 后 回 到 自 定义 通知 对 应 的 布局 文件 ， 找 到 标题 文本 控件 ， 去 掉 对 文字 颜色 
android:textColor 的 属性 设置 ， 再 添加 一 行 对 控件 风格 style 的 属性 设置 。 也 就 是 把 原来 的 如 下 
控件 配置 : 


<TextView 
android:id="(@+id/ty_title" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:textColor="#fffffP" 
android:textSize="17sp" 亡 


改 成 如 下 的 新 配置 : 
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<TextView 
android:id="(@+id/tvy_title" 
android:layout_ width="match parent" 
android:layout_height "wrap_content” 
style="(@style/NotificationTitle" /> 
修改 完毕 ， 这 下 不 管 系统 通知 栏 默 认 的 是 黑 底 白字 ， 还 是 默认 白 底 黑 字 ， 自 定义 消息 的 
标题 文本 都 能 自动 变色 啦 。 


6.5 服务 Service 基础 


本 节 介 绍 为 何 使 用 服务 Service 和 如 何 使 用 服务 ， 包 括 服务 的 生命 周期 和 在 3 种 启 停 方式 
下 的 生命 周期 过 程 ， 有 普通 启 停 、 立 即 绑 定 和 延迟 绑 定 。 另 外 ， 还 介绍 了 怎样 结合 通知 推送 
Notification 实现 把 服务 推送 到 前 台 的 功能 。 


6.5.1 Service 的 生命 周期 


服务 Service 是 Android 的 四 大 组 件 之 一 ， 常 用 在 看 不 见 页 面 的 高 级 场合 ， 如 第 5 章 定时 
器 用 到 了 系统 的 闹钟 服务 ，6.4 节 通 知 推送 用 到 了 系统 的 通知 服务 。 既 然 Android 有 系统 服务 ， 
App 也 可 以 有 自己 的 服务 。Service 与 Activity 相 比 , 不 同 之 处 在 于 没有 对 应 的 页 面 ,相同 之 处 
在 于 有 生命 周期 。 要 想 用 好 服务 ， 就 要 探究 其 生命 周期 。 

下 面 是 Service 与 生命 周期 有 关 的 方法 说 明 。 


e@ onCreate: 创建 服务 。 

e@ onStart: 开始 服务 ，Android 2.0 以 下 版 本 使 用 ， 现 已 废弃 。 

e onStartCommand: 开始 服务 ，Android 2.0 及 以 上 版 本 使 用 。 该 函数 的 返回 值 说 明 见 表 
6-5。 


表 6-5 ”服务 启动 的 返回 值 说 明 

返回 值 说 明 

粘性 的 服务 。 如 果 服 务 进程 被 杀 掉 ， 就 保留 服务 的 状态 为 开始 状态 ， 
但 不 保留 传送 的 Intent 对 象 。 随 后 系统 尝试 重新 创建 服务 ， 由 于 服务 
状态 为 开始 状态 , 因此 创建 服务 后 一 定 会 调用 onStartCommand 方法 。 
如 果 在 此 期 间 没有 任何 启动 命令 传送 给 服务 ， 参 数 Intent 就 为 空 值 
非 粘 性 的 服务 。 使 用 这 个 返回 值 时 ,如 果 服 务 被 异常 杀 掉 ， 系 统 就 不 
会 自动 重启 该 服务 

重 传 Intent 的 服务 。 使 用 这 个 返回 值 时 ， 如 果 服 务 被 异常 杀 掉 ， 系 统 
就 会 自动 重启 该 服务 ， 并 传 入 Intent 的 原 值 

START STICKY COMPATIBILITY | START _STICKY 的 兼容 版 本 ， 不 保证 服务 被 杀 掉 后 一 定 能 重启 


® onDestroy: 销毁 服务 。 


返回 值 类 型 
START_STICKY 








START NOT_STICKY 





START REDELIVER_INTENT 








e onBind: 绑 定 服务 。 

e@ onRebind: 重新 绑 定 。 该 方法 只 有 当 上 次 onUnbind 返回 true 的 时 候 才 会 被 调用 。 

e onUnbind: 解除 绑 定 。 返回 值 为 true 表示 允许 再 次 绑 定 , 再 绑 定时 调用 onRebind 方法 ; 
返回 值 为 false 表示 只 能 绑 定 一 次 ， 不 能 再 次 绑 定 ， 默 认为 false。 


看 来 Service 的 生命 周期 也 不 简单 ， 分 好 几 种 生命 周期 方法 。 原 因 是 服务 存在 多 种 启 停 方 
式 ， 如 普通 启 停 、 立 即 绑 定 、 延 迟 绑 定 ， 每 种 启 停 方式 都 对 应 不 同 的 周期 方法 。 下 面 分 别 叙述 
3 种 启 停 方式 及 其 生命 周期 说 明 。 


1. 普通 启 停 
普通 启 停 是 最 简单 的 用 法 。 下 面 是 该 方式 的 服务 代码 : 


public class NormalService extends Service { 
private static final String TAG = "NormalService"; 


/ 启动 服务 ，Android2.0 以 上 使 用 

public int onStartCommand(Intent intent, int flags, int startid) { 
Log.d(TAG "测试 服务 到 此 一 游 !"); 
return START_STICKY: 

b 


// 绑 定 服务 。 普 通 服务 不 存在 绑 定 和 解 绑 流程 
public IBinder onBind(Intent intent) { 
return null; 
上 
} 


这 个 服务 很 简单 ， 功 能 只 是 打印 一 行 日 志 “ 测 试 服务 到 此 一 游 ! ”。 在 Acitivity 代码 中 ， 
启 停 服务 也 很 简单 ， 调 用 startService 方法 即 可 启动 服务 , 调用 stopService 方法 即 可 停止 服务 。 
当然 ， 也 可 以 在 Intent 对 象 中 传递 参数 信息 。 示 例 的 调用 代码 如 下 : 
/ 创建 一 个 通 往 普 通 服务 的 意图 
Intent intent = new Intent(this, NormalService.class); 
/ 启动 指定 意图 的 服务 
startService(intent); 
普通 启 停 方式 的 服务 生命 周期 可 通过 打印 日 志 观察 ， 也 可 在 页 面 上 直接 显示 日 志 。 启 动 
服务 依次 调用 了 onCreate 与 onStartCommand 方法 , 如 图 6-30 所 示 。 停 止 服务 调用 了 onDestroy 
方法 ， 如 图 6-31 所 示 。 
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启动 服务 停止 服务 启动 服务 停止 服务 
21:07:14 onCreate :07: 
21:07:14 onStartCommand. flags=0 H tt bt flags=0 





21:07:56 onDestroy 





图 6-30 ”启动 服务 的 日 志 图 6-31 停止 服务 的 日 志 
2. 立即 绑 定 


绑 定 方式 的 服务 定义 有 所 不 同 ， 因 为 绑 定 的 服务 可 能 运行 于 另 一 个 进程 ， 所 以 必须 定义 
-个 Binder 对 象 用 来 进行 进程 间 的 通信 。 下 面 是 一 个 绑 定 方式 的 服务 代码 : 
public class BindImmediateService extends Service { 
private static final String TAG = "BindImmediateService"; 
/ 创建 一 个 粘 合剂 对 象 
private final IBinder mBinder = new LocalBinder(); 


/ 定义 一 个 当前 服务 的 粘 合剂 ， 用 于 将 该 服务 黏 到 活动 页 面 的 进程 中 
public class LocalBinder extends Binder { 
public BindImmediateService getServiceO { 
return BindImmediateService.this; 


/ 绑 定 服务 。 返 回 该 服务 的 粘 合剂 对 象 

public IBinder onBind(Intent intent) { 
Log.d(TAG " 绑 定 服务 开始 旅程 !"); 
return mBinder; 


) 


/ 解 绑 服 务 。 返 回 false 表示 只 能 绑 定 一 次 

public boolean onUnbind(Intent intent) { 
Log.d(TAG " 绑 定 服务 结束 旅程 !"); 
return false; 


} 
这 个 服务 在 绑 定 时 会 打印 日 志 “ 绑 定 服务 开始 旅程 ! ”， 在 解除 绑 定时 会 打印 日 志 “ 绑 
定 服务 结束 旅程 ! ”。 在 Activity 中 ， 绑 定 / 解 绑 服务 的 做 法 与 普通 方式 不 同 ， 首 先 要 定义 一 
个 ServiceConnection 的 服务 连接 对 象 ， 然后 调用 bindService 方法 或 unbindService 方法 进行 绑 
定 或 解 绑 操 作 ， 有 具体 的 示例 代码 如 下 : 
public class BindImmediateActivity extends AppCompatActivity implements OnClickListener { 
Private Intent mIntent; / 声明 一 个 意图 对 象 
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(@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_bind_immediate); 
findViewById(R.id.btn_start_bind).setOnClickListener(this); 
findViewById(R.id.btn_unbind).setOnClickListener(this); 
/ 创建 一 个 通 往 立即 绑 定 服务 的 意图 
mIntent=new Intent(this, BindImmediateService.class); 


@Override 
public void onClick(View v) { 
让 (v.getId0 一 Rid.btn_start_bind) { // 点 击 了 绑 定 服务 按钮 
/ 绑 定 服务 。 如 果 服 务 未 启动 ， 则 系统 先 启动 该 服务 再 进行 绑 定 
boolean bindFlag =bindService(mIntent, mFirstConn, ContextBIND_AUTO_CREATE); 
} elseif(vgetId0 一 R.id.btn_unbind) { V 点 击 了 解 绑 服务 按钮 
if (mBindService != nulD) { 
/ 解 绑 服务 。 如 果 先 前 服务 立即 绑 定 ， 则 此 时 解 绑 之 后 自动 停止 服务 
unbindService(mFirstConn); 
mBindService = null; 


private BindImmediateService mBindService; / 声明 一 个 服务 对 象 
private ServiceConnection mFirstConn = new ServiceConnection() { 


/ 获取 服务 对 象 时 的 操作 

public void onServiceConnected(ComponentName name, IBinder service) { 
/ 如 果 服 务 运行 于 另外 一 个 进程 ， 则 不 能 直接 强制 转换 类 型 ， 
// 否则 会 报错 “java.lang.ClassCastException: android.os.BinderProxy cannot be cast to...” 
mBindService = ((BindImmediateService.LocalBinder) service).getService(); 

} 


/ 无 法 获取 到 服务 对 象 时 的 操作 
public void onServiceDisconnected(ComponentName name) { 
mBindService = null; 
} 
bs 
} 
接 下 来 ， 继 续 观察 立即 绑 定 方式 的 生命 周期 ， 该 方式 的 服务 周期 日 志 如 图 6-32 和 图 6-33 
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所 示 。 其 中 ， 图 6-32 所 示 为 立即 绑 定时 的 界面 ， 此 时 依次 调用 onCreate 和 onBind 方法 ; 图 
6-33 所 示 为 立即 解 绑 时 的 界面 ， 此 时 依次 调用 onUnbind 和 onDestroy 方法 。 


Custom Custom 


启动 并 绑 定 服务 解 绑 并 停止 服务 启动 并 绑 定 服务 解 绑 并 停止 服务 


21:10:07 onCreate 21:10:07 onCreate 

21:10:07 onBind 21:10:07 onBind 
21:10:36 onUnbind 
21:10:36 onDestroy 





图 6-32 ”立即 绑 定 的 日 志 图 6-33 ”立即 解 绑 的 日 志 
3. 延迟 绑 定 


延迟 绑 定 与 立即 绑 定 的 区 别 在 于 : 延迟 绑 定 是 在 页 面 上 先 通 过 startService 方法 启动 服务 ， 
然后 通过 bindService 方法 绑 定 已 存在 的 服务 。 这 样 一 来 ， 因 为 启动 操作 在 先 ， 所 以 解 绑 操作 
只 能 撤销 绑 定 操作 ， 而 不 能 撤销 启动 操作 。 由 于 解 绑 服 务 不 能 停止 服务 ， 因 此 存在 再 次 绑 定 服 
务 的 可 能 。 

下 面 观察 延迟 绑 定 的 日 志 ， 验 证 一 下 实际 结果 是 否 符合 之 前 的 猜想 。 依 次 查看 “启动 服 
务 一 绑 定 服务 一 解 绑 服 务 ” 的 运行 日 志 ， 如 图 6-34 所 示 ， 依 次 查看 “ 绑 定 服务 一 解 绑 服 务 一 
停止 服务 ”的 运行 日 志 ， 如 图 6-35 所 示 。 














Custom Custom 


启动 服务 。” 绑 定 服务 。 解 绑 服 务 。 停止 服务 启动 服务 。” 绑 定 服务 。 解 绑 服务 。 停止 服务 


21:11:12 onCreate 21:11:12 onCreate 
21:11:12 onStart 21:11:12 onStart 
21:11:20 onBind 21:11:20 onBind 
21:11:53 onUnbind :53 onUnbind 


:36 onRebind 


4 
21:12:42 onUnbind 
21:12:42 onDestroy 





图 6-34 延迟 绑 定 的 日 志 图 6-35 再 次 绑 定 的 日 志 
从 日 志 中 可 以 看 到 ， 延 迟 绑 定 与 立即 绑 定 两 种 方式 的 生命 周期 区 别 在 于 : 
(1) 延迟 绑 定 的 首次 绑 定 操 作 只 调用 onBind 方法 ， 再 次 绑 定 只 调用 onRebind 方法 (是 


否 允许 再 次 绑 定 要 看 上 次 onUnbind 方法 的 返回 值 ) 。 
(2) 延迟 绑 定 的 解 绑 操 作 只 调用 onUnbind 方法 。 


6.5.2 ”推送 服务 到 前 台 


服务 没有 自己 的 布局 文件 ， 也 就 意味 着 无 法 直接 在 页 面 上 展示 ， 要 想 了 解 服务 的 运行 情 
况 ， 要 么 通过 打印 日 志 ， 要 么 获取 某 个 页 面 的 静态 对 象 ， 然 后 在 该 页 面 上 显示 运行 结果 。 然 而 
活动 页 面 有 自身 的 生命 周期 , 极 有 可 能 发 生 服务 尚 在 运行 但 页 面 早已 退出 的 情况 , 所 以 该 方式 
不 可 靠 。 幸 好 , 服务 不 只 能 在 外 部 进行 启 停 或 绑 定 , 还 能 在 内 部 模拟 启 停 ， 当然 仅 是 模拟 而 已 。 

服务 内 部 的 启 停 方法 也 有 对 应 的 两 个 函数 。 
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@ startForeground: 把 当前 服务 切换 到 前 台 运 行 。 第 一 个 参数 表示 通知 的 编号 ， 第 二 个 参 
数 表示 Notification 对 象 ， 意 味 着 切换 到 前 台 就 是 展示 到 通知 栏 。 
e@ ”stopForeground: 停止 前 台 运 行 。 参 数 为 true 表示 清除 通知 ， 参 数 为 false 表示 不 清除 
注意 ， 从 Android 9.0 开始 ， 要 想 在 服务 中 正常 调用 startForeground 方法 ， 还 需 修 改 
AndroidManifestxml， 添 加 如 下 所 示 的 前 台 服 务 权 限 配置 
<!-- 允许 前 台 服务 -> 
<uses-permission android:name="android.permission.FOREGROUND SERVICE" 亡 
服务 在 前 台 运 行 的 一 个 常见 的 应 用 是 音乐 播放 器 ， 即 使 用 户 离 开 了 播放 器 页 面 ， 手 机 仍 
然 能 在 后 台 继续 播放 音乐 , 同时 还 能 在 通知 栏 查看 播放 进度 , 控制 播放 与 暂停 操作 。 音 乐 服务 
的 源码 较 长 ， 限 于 篇 幅 这 里 就 不 贴 出 来 了 ， 读 者 可 参考 本 书 附带 源码 custom 模块 的 
MusicService.java 和 NotifyServiceActivity.java。e 特 别 注意 示例 源码 针对 点 击 播放 /暂停 按钮 的 处 
理 ， 此 时 触发 的 延迟 意图 对 象 由 getBroadcast 方法 获得 ， 原 因 是 getActivity 获得 的 对 象 只 会 跳 
转 到 某 个 页 面 ， 要 想 让 触发 的 事件 作用 于 服务 内 部 ， 只 能 通过 广播 的 方式 。 
音乐 播放 服务 的 前 台 运 行 效果 如 图 6-36 和 图 6-37 所 示 。 其 中 ， 图 6-36 所 示 为 正在 播放 
的 通知 栏 界面 ， 图 6-37 所 示 为 暂停 播放 的 通知 栏 界面 。 





全 让 我 们 荡 起 双 桨 正在 播放 @ 让 我 们 荡 起 双 桨 暂停 播放 


图 6-36 正在 播放 的 通知 栏 界面 图 6-37 暂停 播放 的 通知 栏 界面 





6.6 ”实战 项 目 : 手机 安全 助手 


本 节 将 设计 一 个 实战 项 目 一 一 手机 安全 助手 ， 该 项 目 采用 多 种 自 定义 控件 的 相关 技术 ， 
并 同时 运用 多 种 存储 技术 。 通过 该 实战 项 目的 练习 能 够 加 深 自 定义 控件 的 用 法 理解 , 还 能 复习 
巩固 前 两 章 的 存储 技术 知识 。 
6.6.1 设计 思 


如 同 电脑 上 的 杀毒 软件 , 手机 上 也 有 形形色色 的 安全 App, 比如 ** 安 全 管家 、** 安 全 卫士 、 
** 安 全 助手 等 ， 这 些 安全 App 都 有 一 个 核心 模块 一 一 流量 监控 功能 。 现 在 运营 商都 靠 流量 赚 
钱 ， 比 如 100M 流量 要 10 元 钱 、1G 流量 要 100 元 ， 很 多 App 一 打开 就 是 满 屏 图 片 ， 非 常 费 
流量 ， 而 且 有 的 App 会 偷 跑 流量 ， 很 多 用 户 不 知 不 觉 电话 费 就 被 流量 花 光 了 。 所 以 流量 监控 
的 功能 很 实用 ， 它 的 基础 实现 也 不 难 ， 下 面 就 以 流量 监控 为 例 ， 开 展 一 个 “手机 安全 助手 ”的 
实战 项 目 ， 活 学 活用 本 章 自 定义 控件 的 相关 知识 。 

先 来 看 手机 安全 助手 的 总 体 页 面 效 果 。 为 了 起 到 提醒 作用 ， 对 于 超出 限额 的 流量 部 分 使 
用 含有 警示 意义 的 橙色 显示 ,如 果 当 天 已 用 流量 未 超出 限额 ,就 使 用 绿色 显示 流量 信息 ， 如 图 
6-38 所 示 。 总 体 的 流量 使 用 情况 展示 在 页 面 上 方 ， 页 面 下 方 则 显示 每 个 应 用 的 单独 流量 消耗 ， 
把 整个 流量 页 面 往 上 拉动 ， 应 用 列表 也 随 之 向 上 滚动 ， 如 图 6-39 所 示 。 














第 6 章 自 定义 控件 | 231 












com.tencent.mm 14.5M 








今日 已 用 流量 27.7M 


本 月 已 用 流量 待 统计 0 


微 信 com.tencent.mm 14.5M 


京东 pom ingd eng pp 5.2M 


com.jingdong.app. 

mall 5.2M 
cn.amazon.mShop. 
android 22M 


com.taobao.taobao 2.2M 







com.dangdang.buy 1.6M 
2 , 


al 


amazon ”亚马逊 购 cn.amazon.mShop. 2.2M 
"Was 物 android 


手机 淘宝 com.taobao.taobao 2.2M 


com.mygolbs.mybu 652.2K 





CSDN net.csdn.csdnplus 582.5K 


YunOS 桌 com.aliyun.homesh _s41 4k 





图 6-38 手机 安全 助手 的 流量 页 面 图 6-39 上 拉 应 用 列表 的 流量 页 面 
上 面 说 的 流量 限额 可 在 配置 页 面 填写 ， 当 然 也 可 自动 校准 ， 通 过 监控 短信 箱 实现 流量 校 


准 的 功能 参见 第 4 章 的 “4.5.3 ”内 容 观察 器 ContentObserver”。 具 体 的 流量 限额 配置 页 面 效 
果 如 图 6-40 所 示 。 


custom 


每 日 限额 ，68 MB 





图 6-40 流量 限额 配置 页 面 


再 来 看 助手 App 的 通知 栏 效果 ， 超 出 限额 的 流量 同样 使 用 橙色 进度 条 展示 ， 如 图 6-41 所 
示 ; 若 未 超出 当日 限额 ， 则 使 用 绿色 展示 进度 条 ， 如 图 6-42 所 示 。 


2 手机 安全 助手 实时 监控 中 


上 到 今日 已 用 流量 34.3M 





图 6-41 流量 限额 为 30M 的 通知 栏 图 6-42 流量 限额 为 50M 的 通知 栏 

下 面 来 看 这 个 安全 助手 用 到 了 本 章 哪些 新 技术 ， 机 灵 的 你 一 定 不 会 错过 以 下 5 点 。 

e@ 自 定义 日 期 对 话 框 : 最 上 面 的 标题 栏 ， 统 计 日 期 的 选择 对 话 框 可 采用 自 定义 形式 。 

e。 自 定 义 圆 弧 动 画 : 页 面 上 方 的 流量 信息 ， 使 用 圆 弧 动画 展示 当天 的 已 用 流量 ， 并 通过 
圆 纹 颜色 提醒 当前 流量 是 否 超标 。 

e 不 滚动 列表 视图 : 应 用 列表 与 流量 圆 弧 一 起 上 挪 ， 意 味 着 二 者 被 同一 个 ScrollView 包 
庄 ， 此 时 应 用 列表 必须 采用 全 部 展开 的 不 滚动 列表 视图 。 
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e 自 定义 通知 栏 : 通知 栏 中 包含 定制 样式 的 进度 条 ， 必 须 采用 自 定义 通知 栏 。 
e@ 服务 Service: 流量 数据 每 间隔 一 段 时 间 就 得 重新 获取 ， 这 种 定时 处 理 无 法 在 Acitivity 
页 面 进行 ， 只 能 在 服务 Service 中 处 理 。 


另外 ， 安 全 助手 还 运用 了 多 种 存储 技术 ， 下 面 一 一 道 来 。 


e 数据 库 : 毫 无 疑问 ， 历 史 流 量 数据 必须 保存 在 数据 库 中 。 

ee 共享 参数 : 每 日 的 流量 限额 可 直接 保存 在 共享 参数 中 。 

e 全 局 内 存 : 也 许 读者 不 理解 这 里 跟 全 局 内 存 有 什么 关系 ， 其 实 全 局 内 存 要 保存 数据 库 
连接 ， 因 为 主页 面 需 要 通过 数据 库 查 询 流 量 数 据 ， 后 台 服 务 也 要 不 断 获取 流量 数据 并 
更 新 至 数据 库 ， 既 然 不 止 一 个 地 方 用 到 数据 库 连 接 ， 不 如 统一 放 到 全 局 内 存 中 ， 还 可 
以 避免 数据 库 重 复 打开 和 意外 关闭 的 异常 。 

e 内 容 观 察 器 : 第 4 章 提 到 内 容 组 件 时 ， 介 绍 了 如 何 实现 流量 校准 功能 ， 该 技术 正好 在 
本 章 的 实战 项 目 中 派 上 用 场 了 。 


如 此 看 来 ， 该 实战 项 目 不 但 可 以 演练 各 种 自 定义 控件 ， 而 且 可 以 复习 第 4 章 的 数据 存储 
技术 ， 可 谓 一 举 两 得 。 


6.6.2 ”小 知识 : 应 用 包 管 理 器 PackageManager 


手机 安全 管理 涉及 获取 已 安装 应 用 的 应 用 包 信息 ， 包 括 应 用 的 进程 编号 、 名 称 、 图 标 以 
及 流量 信息 。 其 中 ， 应 用 包 的 基本 信息 可 通过 PackageManager 与 ApplicationInfo 联合 获得 ， 
应 用 包 信 息 的 获取 代码 如 下 : 


/ 获取 已 安装 的 应 用 信息 队列 
public static ArrayList<AppInfo> getAppInfo(Context ctx, int type) { 
ArrayList<AppInfo> appList = new ArrayList<AppInfo>(); 
SparseIntArray siArray = new SparseIntArray(); 
/ 获得 应 用 包 管 理 器 
PackageManager pm = ctx.getPackageManager(); 
/ 获取 系统 中 已 经 安装 的 应 用 列表 
List<ApplicationInfo> installList = pm.getInstalledApplications( 
PackageManagerPERMISSION_GRANTED); 
for (inti= 0;i< installListsizeO; i++) { 
ApplicationInfo item = installListget(i; 
/ 去 掉 重复 的 应 用 信息 
if (siArray.indexOfKey(item.uid) >= 0) { 
continue; 
} 
// 往 siArray 中 添加 一 个 应 用 编号 ， 以 便 后 续 的 去 重 校 验 
siArray.put(item.uid, 1); 
ty { 
/ 获取 该 应 用 的 权限 列表 
String[] permissions = pm.getPackageInfo(item.packageName, 
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PackageManager.GET PERMISSIONS).requestedPermissions; 
if (permissions 一 nulD) { 
continue; 
4 
boolean isQueryNetwork = false; 
for (String permission : permissions) { 
// 过 滤 那 些 具备 上 网 权限 的 应 用 
if (permission.equals("android.permission.INTERNET")) { 
isQueryNetwork = true; 
break; 
!; 
!; 
// 类 型 为 0 表示 所 有 应 用 ， 为 1 表示 只 要 联网 应 用 
if (type — 0||(type — 1 && isQueryNetwork)) { 
AppInfo app = new AppInfo(); 
app.uid = item.uid; / 获取 应 用 的 编号 
app.label = item.loadLabel(pm)toString(); / 获取 应 用 的 名 称 
app.package_name = item.packageName; // 获取 应 用 的 包 名 
app.icon = item.loadIcon(pm); / 获取 应 用 的 图 标 
appList.add(app); 
} catch (Exception e) { 
€.printStackTrace(); 
continue; 
} 
} 
return appList; // 返回 去 重 后 的 应 用 包 队列 
应 用 产生 的 流量 数据 可 通过 工具 类 TrafficStats 读 取 ， 该 工具 有 以 下 6 种 常用 方法 。 
getTotalRxBytes: 获取 接收 流量 的 总 字 节 数 。 
getTotalTxBytes: 获取 发 送 流量 的 总 字 节 数 。 
getMobileRxBytes: 获取 数据 连接 接收 流量 的 总 字 节 数 。 包 含 移动 数据 流量 ， 不 含 wifi 
流量 。 
getMobileTxBytes: 获取 数据 连接 发 送 流量 的 总 字 节 数 。 
getUidRxBytes: 获取 指定 进程 接收 流量 的 总 字 节 数 。 
getUidTxBytes: 获取 指定 进程 发 送 流量 的 总 字 节 数 。 
获取 已 安装 应 用 的 包 信息 与 流量 信息 的 效果 如 图 6-43 和 图 6-44 所 示 ， 其 中 图 6-43 为 具 
备 联 网 权限 的 应 用 包 信 息 列 表 ， 图 6-44 为 总 流量 与 分 应 用 的 流量 列表 。 
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应 用 类 型 ; 联网 应 用 = 
应 用 图 标 应 用 名 称 应 用 包 名 应 用 ID 


FM 电台 us 10007 


当前 总 共 接 收 流量 : 309.3M 
其 中 接收 数据 ; 


1.7M 
其中 发 送 数 所 泊 生 : 63.5M 
应 用 图 标 应 用 名 称 应 用 包 名 











GBA com.android.fmradi 
i com.mediatek.gba 1001 FM 电台 

Of 9 共享 单 0.ofoJabofo 10119 SEA com.mediatek.gba 
1 Gopal er de 10049 ofo 0 二 


联系 人 服 com.yunos.contact 


com.yunos.theme.t 
ul 9 主题 中 service 


心 hememanager 10037 








6-43 具备 联网 权限 的 应 用 包 列 表 6-44 总 流量 与 分 应 用 的 流量 列表 

6.6.3 ”代码 示例 

本 章 的 实战 项 目 依然 要 考虑 代码 架构 ， 故 而 编码 过 程 与 第 5 章 一 样 分 为 5 步 。 

ET) 设计 代码 架构 ， 初 步 拆 分 后 的 package 包 分 为 以 下 7 部 分 。 
com.example.assistant.activity: 存放 Acitivity 页 面 的 代码 。 
com.example.assistant.adapter: 存放 适配器 的 代码 。 
com.example.assistant.bean: 存放 实体 数据 结构 的 代码 ， 如 日 流量 的 字段 信息 
com.example.assistant.database: 存放 读 写 SQLite 的 数据 库 操作 代码 。 
com.example.assistant.service: 存放 服务 Service 的 代码 。 


com.example.assistant.util: 存放 工具 类 的 代码 。 
com.example.assistant.widget: 存放 自 定义 控件 的 代码 。 


30 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 流量 主页 面 的 代码 文 伯 











接收 流量 








0B 





+ 取 名 








的 代 





MobileAssistantActivity.java， 对 应 的 布局 文件 名 是 activity_mobile_assistant.xml; 限额 设置 页 





码 文件 取 名 MobileConfigActivityjava， 对 应 的 布局 文件 名 是 activity_ mobile_config.xml。 不 要 忘 了 
流量 统计 服务 的 代码 文件 TrafficServicejava, 还 有 适配器 、 对话 框 、 远程 视图 的 代码 及 其 布局 文件 ， 








读者 可 自行 构思 。 
C03 在 AndroidManifestxml 中 补充 相应 配置 ， 主 要 有 以 下 3 点。 


(1) 注册 两 个 页 面 的 acitivity 节点 ， 注 册 代 码 如 下 : 

















<activity android:name=".MobileAssistantActivity" 亡 
<activity android:name=".MobileConfigActivity" /> 


(2) 注册 流量 统计 服务 的 service 节点 ， 注 册 代 码 如 下 : 
<service android:name=".service.TrafficService" android:enabled="true" > 
(3) 给 application 补充 name 属性 ， 值 为 MainApplication， 举 例如 下 : 
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android:name=".MainApplication" 
C704 在 资源 目录 下 补充 相应 的 XML 配置。 


(1) 在 res/drawable 目录 加 入 定制 进度 条 需要 的 层次 图 形 描述 文件 。 
(2) 在 res/layout 目录 下 编写 页 面 、 适 配器 、 对 话 框 、 远 程 视 图 对 应 的 布局 文件 。 
(3) 在 res/values/styles.xml 中 补充 自 定义 日 期 对 话 框 的 样式 定义 。 


人 ED5 进 行 java 代码 开发 ， 包 括 对 页 面 、 适 配器 、 对 话 框 、 后 台 服 务 等 进行 编码 。 


下 面 简单 介绍 一 下 本 书 附 带 源码 custom 模块 中 ， 与 手机 安全 助手 有 关 的 主要 代码 之 间 的 
关系 : 

(1) MobileAssistantActivity.java: 这 个 是 手机 安全 助手 的 主页 面 ， 上 半 部 分 展示 当月 和 
当天 的 流量 总 体 使 用 情况 ,下 半 部 分 展示 每 个 应 用 的 流量 消耗 明细 数据 。 如 果 已 使 用 流量 超出 
两 倍 限额 ， 则 展示 红色 圆 弧 进度 ; 如 果 已 使 用 流量 超出 一 倍 限额 ， 则 展示 橙色 圆 弧 进度 ;如果 
已 使 用 流量 未 超出 限额 ， 则 展示 绿色 圆 弧 进度 。 

(2) MobileConfigActivity.java: 点 击 主页 面 右上 角 的 三 点 菜单 图 标 ， 则 跳 转 到 流量 限额 
配置 页 面 。 该 配置 页 面 既 支持 手工 填写 月 流量 限额 、 日 流量 限额 ， 也 支持 由 App 自动 校准 流 
量 限额 数值 。 所 谓 的 自动 校准 ,， 即 是 先 由 手机 自动 发 送 流 量 查 询 短信 给 运营 商 的 客服 号 , 等待 
运营 商 客服 号 下 发 流量 校准 短信 ， 然 后 App 通过 解析 短信 内 容 获 得 并 保存 详细 的 流量 配额 数 
据 。 

(3) TrafficServicejava: 为 了 方便 用 户 查看 实时 的 流量 消耗 信息 ， 就 要 把 流量 监控 结果 
推送 到 通知 栏 , 于 是 后 台 静 默 运 行 的 流量 服务 便 派 上 用 场 了 。 它 每 隔 一 段 时 间 , 自动 获取 最 新 
的 流量 信息 ， 并 将 最 新 的 监控 结果 推送 到 前 台 ， 也 就 是 实时 刷新 通知 栏 上 面 的 流量 消息 。 





6.7 小 结 


本 章 主 要 介绍 了 App 开发 的 自 定义 控件 相关 知识 ， 包 括 自 定义 视图 的 步骤 (声明 属性 、 
构造 对 象 、 测 量 尺寸 、 绘 制 视 图 ) 、 自 定义 简单 动画 (任务 片段 、 下 拉 刷 新 动画 、 圆 弧 进 度 动 
画 ) 、 自 定义 对 话 框 的 操作 〈 对 话 框 、 改 进 日 期 对 话 框 、 自 定义 多 级 对 话 框 ) 、 自 定义 通知 栏 
的 用 法 (通知 推送 、 进 度 条 、 远 程 视图 ) 、Service 组 件 的 基本 用 法 (生命 周期 、3 种 启 停 方 式 、 
推送 服务 到 前 台 ) 。 最 后 设计 了 一 个 实战 项 目 “ 手 机 安全 助手 ”， 在 该 项 目的 App 编码 中 采 
用 了 本 章 介绍 的 大 部 分 自 定义 控件 知识 ,以 及 服务 启 停 和 推送 到 通知 栏 的 处 理 。 另 外 ,还 介绍 
了 如 何 获取 手机 上 的 应 用 包 信 息 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 。 

(1) 学 会 自 定义 简单 控件 ， 包 括 静 止 的 视图 和 简单 的 动画 。 

(2) 学 会 自 定义 对 话 框 ， 在 页 面 的 合适 位 置 显示 和 控制 对 话 框 。 

(3) 学 会 自 定义 通知 栏 ， 包 括 自 定义 样式 与 自 定义 操作 的 处 理 。 

(4) 学 会 服务 组 件 Service 的 用 法 ， 如 启 停 服务 、 绑 定 / 解 绑 服 务 、 把 服务 推送 到 前 台 





本 章 介绍 App 开发 常用 的 一 些 组 合 控件 ， 主 要 包括 底部 标签 栏 的 实现 和 用 法 、 项 部 导航 
栏 的 用 法 、 横 幅 轮 播 条 的 实现 和 用 法 、 循 环视 图 3 种 布局 的 用 法 、 材 质 设计 库 3 种 布局 的 用 法 
等 。 最 后 结合 本 章 所 学 的 知识 分 别 演示 了 两 个 实战 项 目 “ 仿 支付 宝 的 头 部 伸缩 特效 ”和 “ 仿 淘 
宝 主 页 ”的 设计 与 实现 。 


7.1 标 签 栏 


本 节 介 绍 底部 标签 栏 的 实现 与 用 法 ， 首 先 说 明 如 何 自 定义 实现 标签 按钮 ， 然 后 介绍 标签 
栏 的 3 种 实现 方式 ， 即 TabActivity 方式 、ActivityGroup 方式 和 FragmentActivity 方式 。 


7.1.1 标签 按钮 


按钮 控件 种 类 繁多 ， 有 文本 按钮 Button、 图 像 按 钮 ImageButton、 单 选 按钮 RadioButton、 
复 选 按钮 CheckBox、 开 关 按 钮 Switch 等 ， 可 展现 的 ~ 
形式 有 文本 、 图 像 、 文 本 + 图 标 ， 如 此 丰富 的 展现 形 ee 
式 , 已 经 能 够 满足 大 部 分 控制 需求 。 但 总 有 少数 场合 人 2 . 
比较 特殊 ， 一 般 的 按钮 样式 满足 不 了 ， 比 如 图 7-1 所 
示 的 微 信 底部 标签 栏 ， 一 排 有 4 个 标签 按钮 ， 每 个 按 
钮 的 图 标 和 文字 都 会 随 着 选中 操作 而 高 亮 显示 。 

这 样 的 标签 栏 控件 是 各 大 主流 App 的 标 配 ， 无 论 是 淘宝 、 京 东 ， 还 是 微 信 、 手 机 QQ, 首 
屏 底部 一 律 是 清一色 的 标签 栏 ， 而 且 在 选中 标签 按钮 时 经 常 文字 、 图 标 、 背 景 一 起 高 亮 显 示 。 
像 这 种 标签 按钮 ，Android 似乎 没有 对 应 的 专门 控件 ， 如 果 要 自 定 义 控 件 ， 就 得 设计 一 个 布局 
容器 , 里 面 放 入 一 个 文本 控件 和 图 像 控件 , 然后 注册 选中 事件 的 监听 器 , 一 旦 监听 到 选中 事件 ， 








7-1 微 信 的 底部 标签 栏 


第 7 章 组 合 控件 | 237 





就 高 亮 显示 文字 、 图 标 与 布局 背景 。 
自 定义 控件 固然 是 一 个 不 错 的 思路 ， 不 过 无 须 如 此 大 动 干戈 。 读 者 还 记得 第 2 章 介 绍 
关 按 钮 Switch 时 结合 状态 图 形 与 复 选 框 实现 仿 iOS 开关 按钮 的 例子 吧 ， 通 过 状态 图 形 自动 展 
示 选 中 与 未 选中 两 种 状态 的 图 像 在 外 观 上 就 像 一 个 新 控件 。 标签 控件 也 是 如 此 , 要 想 高 亮 显 示 
背景 ， 可 通过 给 background 属性 设置 状态 图 形 ; 要 想 高 亮 显示 图 标 ， 可 通过 给 drawableTop 
属性 设置 状态 图 形 ， 高 亮 显示 文本 也 能 通过 给 textColor 属性 设置 状态 图 形 实现 。 这 个 小 技巧 
估计 很 多 人 都 没 用 过 ， 既 然 文字 、 图 标 、 背 景 都 可 以 通过 StateDrawable 控制 是 否 高 亮 显示 ， 
接 下 来 的 事情 就 好 办 了 ， 具 体 的 实现 步骤 如 下 : 
人 ET 定义 一 个 状态 图 形 的 XML 描述 文件 ， 当 状态 为 选中 时 展示 高 亮 图 形 ， 代 码 如 下 : 
<selector xmlns:android="http://schemas.android.comy/apk/res/android"> 
<item android:state_selected="true" android:color="(@color/tab_text_selected" /> 
<item android:color="(@color/tab_text_normal" /> 
</selector> 
(02 在 布局 文件 中 给 TextView 控件 的 background、textColor、drawableTop 三 个 属性 分 别 设 
置 对 应 的 状态 图 形 ， 设 置 代码 举例 如 下 : 


<!-- 注意 这 个 文本 视图 的 背景 、 文 字 颜 色 和 顶部 图 标 都 采用 了 状态 图 形 ， 使 其 看 起 来 像 个 细 新 的 
标签 控件 -> 

<TextView 
android:id="(@+id/tvy_tab_button" 
android:layout_width="100dp" 
android:layout_height="60dp" 
android:padding="Sdp" 
android:layout_gravity="center" 
android:gravity="center" 
android:background="(@drawable/tab_bg_selector" 
android:text=" 点 我 " 
android:textSize="12sp" 
android:textColor="(@drawable/tab_text_selector" 
android:drawableTop="(@drawable/tab_first_selector" /> 


703 在 代码 中 调用 TextView 对 象 的 setSelected(true) 方 法 时 ， 该 控件 的 文字 、 图 标 、 背 景 同 
时 高 亮 显示 ; 调用 setSelected(false) 方 法 时 ， 该 控件 的 文字 、 图 标 、 背 景 恢复 原状 。 具 体 效果 如 图 7-2 
和 图 7-3 所 示 ， 图 7-2 所 示 为 尚未 选中 时 的 截图 ， 图 7-3 所 示 为 选中 时 的 截图 。 

















































































































选 定 标签 按钮 


选 定 标签 按钮 





点 我 





图 7-2 未 选中 标签 按钮 的 截图 图 7-3 选中 标签 按钮 的 截图 


是 不 是 很 神奇 ? 接 下 来 我 们 把 该 控件 的 共同 属性 挑 出 来 ， 因 为 底部 标签 栏 有 4、5 个 标签 
按钮 , 如 果 每 个 按钮 节点 都 添加 重复 的 属性 , 就 太 嘿 味 了 , 所 以 把 它们 之 间 通 用 的 属性 挑 出 来 ， 
然后 在 values/styles.xml 中 定义 名 为 TabButton 的 新 风格 ， 具 体 的 定义 代码 如 下 : 


<style name="TabButton"> 

<item name="android:layout_width">match parent</item> 

<item name="android:layout_height">match_ parent</item> 

<item name="android:padding">5dp</item> 

<item name="android:layout gravity">center</item> 

<item name="android:gravity">center</item> 

<item name="android:background">(@drawable/tab_bg_selector</item> 

<item name="android:textSize">12sp</item> 

<item name="android:textStyle">normal</item> 

<item name="android:textColor">(@drawable/tab_text_selector</item> 
</style> 








接 下 来 ， 布 局 文件 只 要 给 TextView 节点 添加 一 行 style="@style/TabButton"， 即 可 完成 标 
签 按钮 的 声明 。 直 接 在 styles.xml 中 定义 风格 ,无须 另 外 编写 自 定义 控件 的 代码 ， 这 是 自 定义 
控件 的 另 一 种 途径 。 


7.1.2 ”实现 底部 标签 栏 


有 了 单个 标签 按钮 ， 还 需要 一 个 边框 把 这 些 按钮 放 进去 ， 自 动 响应 每 个 按钮 的 点 击 操作 ， 
才能 形成 一 个 真正 可 用 的 底部 标签 栏 。 由 于 点 击 标签 切换 页 面 时 标签 栏 自 身 仍 保持 不 动 , 因此 
这 种 情况 不 宜 直接 采用 通常 的 活动 页 面 跳 转 ， 只 能 通过 特定 形式 完成 页 面 切换 。 

标签 栏 的 页 面 切换 主要 有 3 种 方式 : 基于 TabActivity 的 标签 栏 、 基 于 ActivityGroup 的 标 
签 栏 和 基于 FragmentActivity 的 标签 栏 ，3 种 方式 各 有 千秋 。 


1. 基于 TabActivity 的 标签 栏 


TabActivity 原本 就 是 设计 用 来 做 标签 页 面 的 ， 并 且 提 供 了 TabHost 和 TabWidget 两 个 控 
只 不 过 它们 仅 用 于 标签 栏 ， 所 以 无 须 深入 了 解 ， 套 用 固定 的 框架 就 行 。 
下 面 是 TabActivity 方式 的 布局 文件 内 容 : 
<!-- 该 方式 的 底部 标签 栏 ， 根 布局 必须 是 TabHost， 且 id 必须 为 @android:id/tabhost --> 
<TabHost xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="(@android:id/tabhost" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


件 





<RelativeLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<!- 内 容 页 面 都 挂 在 这 个 框架 布局 下 面 -> 
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<FrameLayout 
android:id="(@android:id/tabcontent" 
android:layout width="match parent" 
android:layout_ height="match parent" 
android:layout_ marginBottom="@dimen/tabbar height" /> 


<!- 这 是 例行公事 的 选项 部 件 ， 实 际 隐藏 掉 了 -~ 
<TabWidget 
android:id="(@android:id/tabs" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:visibility="gone" /> 


<!- 下 面 是 事实 上 的 底部 标签 栏 ， 采 取水 平 线性 布局 展示 --> 
<LinearLayout 
android:layout_ width="match_parent" 
android:layout_height="(@dimen/tabbar_height" 
android:layout_alignParentBottom="true" 
android:gravity="bottom" 
android:orientation="horizontal"> 


<!-- 第 一 个 标签 控件 -> 

<LinearLayout 
android:id="(@+id/ll first" 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="1" 
android:orientation="vertical"> 


<TextView 
style="(@style/TabButton" 
android:drawableTop="(@drawable/tab_first_selector" 
android:text="(@string/menu_first" /> 
</LinearLayout> 


<!-- 第 二 个 标签 控件 --> 

<LinearLayout 
android:id="(@+id/ll_second" 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="1" 
android:orientation="vertical"> 


240 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


<TextView 
style="(@style/TabButton" 
android:drawableTop="(@drawable/tab_second_selector" 
android:text="(@string/menu_second" /> 
</LinearLayout> 


<!-- 第 三 个 标签 控件 --> 

<LinearLayout 
android:id="(@+id/ll third" 
android:layout_width="0dp" 
android:layout_height="match_parent" 





android:layout_ weight="1" 
android:orientation="vertical"> 


<TextView 
style="(@style/TabButton" 
android:drawableTop="(@drawable/tab_third_selector" 
android:text="(@string/menu_third" /> 
</LinearLayout> 
</LinearLayout> 
</RelativeLayout> 
</TabHost> 


有 了 布局 文件 ， 再 来 看 对 应 的 Activity 框架 ， 下 面 是 TabActivity 的 代码 : 


public class TabHostActivity extends TabActivity implements OnClickListener { 
private static final String TAG = "TabHostActivity"; 
private Bundle mBundle = new Bundle();，// 声明 一 个 包 囊 对 象 
private TabHost tab host / 声明 一 个 标签 栏 对 象 
private LinearLayout 1L_first ll_second, ll_third; 
private String FIRST_ TAG = "first" // 第 一 个 标签 的 标识 串 
private String SECOND_TAG = "second"; // 第 二 个 标签 的 标识 串 
private String THIRD_TAG = "third"; / 第 三 个 标签 的 标识 串 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_tab_host); 
mBundle.putString("tag", TAG); / 往 包 于 中 存 入 名 叫 tag 的 标记 串 
11 first = findViewById(R.id.ll_first); / 获取 第 一 个 标签 的 线性 布局 
中 second = findViewById(R.id.IL_second); / 获取 第 二 个 标签 的 线性 布局 
1L_third = findViewById(R.id.ll_third); / 获取 第 三 个 标签 的 线性 布局 
1L_firstsetOnClickListener(this); / 给 第 一 个 标签 注册 点 击 监听 器 
1L_second.setOnClickListener(this); / 给 第 二 个 标签 注册 点 击 监 听 器 
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1Lthird.setOnClickListener(this)) // 给 第 三 个 标签 注册 点 击 监听 器 

/ 获取 系统 自 带 的 标签 栏 ， 其 实 就 是 id 为 “@android:id/tabhost” 的 控件 

tab_host = getTabHost(); 

// 往 标签 栏 添加 第 一 个 标签 ， 其 中 内 容 视图 展示 TabFirstActivity 

tab_host.addTab(getNewTab(FIRST_TAG, R.string.menu first, 
R.drawable.tab_first_selector, TabFirstActivity.class)); 

// 往 标签 栏 添加 第 二 个 标签 ， 其 中 内 容 视 图 展示 TabSecondActivity 

tab_host.addTab(getNewTab(SECOND TAG, R.string.menu_second, 
R.drawable.tab_second selector, TabSecondActivity.class)); 

/ 往 标签 栏 添加 第 三 个 标签 ， 其 中 内 容 视图 展示 TabThirdActivity 

tab_host.addTab(getNewTab(THIRD_TAG, R.string.menu_ third, 
R.drawable.tab_third_selector, TabThirdActivity.class)); 

changeContainerView(ll first); / 默认 显示 第 一 个 标签 的 内 容 视图 


/ 根据 定制 参数 获得 新 的 标签 规格 

private TabHost.TabSpec getNewTab(String spec, int label, int icon, Class<?> cls) { 
/ 创建 一 个 意图 ， 并 存 入 指定 包 囊 
Intent intent = new Intent(this, cls).putExtras(mBundle); 
/ 生成 并 返回 新 的 标签 规格 〈 包 括 内 容 意图 、 标 签 文字 和 标签 图 标 ) 
return tab_host.newTabSpec(spec).setContent(intent) 

.setIndicator(getString(label), getResources().getDrawable(icon)); 
j; 


(QOverride 
public void onClick(View v) { 
if (v.getId) 一 R.id.ll_first || v.getld() 一 R.id.ll_second | vsgetId0 一 R.id.IL third) { 
changeContainerView(v); // 点 击 了 哪个 标签 ， 就 切换 到 该 标签 对 应 的 内 容 视图 


/ 内 容 视图 改 为 展示 指定 的 视图 
Private void changeContainerView(View v) { 
1L_firstsetSelected(false); / 取消 选中 第 一 个 标签 
1L_second.setSelected(false); / 取消 选中 第 二 个 标签 
1L_third.setSelected(false); / 取消 选中 第 三 个 标签 
VsetSelected(true); / 选中 指定 标签 
if (v=—= 1 first) { 
tab_host.setCurrentTabByTag(FIRST_TAG); / 设置 当前 标签 为 第 一 个 标签 
} elseif (v=— 1l second) { 
tab_host.setCurrentTabByTag(SECOND_TAG); // 设置 当前 标签 为 第 二 个 标签 
} elseif (v— 1 third) { 
tab_host.setCurrentTabByTag(THIRD_TAG); / 设置 当前 标签 为 第 三 个 标签 
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} 


} 


该 方式 的 核心 是 getNewTab 函数 ， 方 法 内 部 可 设置 标签 按钮 的 文本 、 图 标 以 及 该 标签 对 
应 的 活动 页 面 。 当 发 生 标 签 按钮 的 点 击 事件 时 ， 系 统 调用 TabHost 的 setCurrentTabByTag 方法 
定位 具体 的 切换 页 面 。 

有 具体 的 标签 页 切换 效果 如 图 7-4 和 图 7-5 所 示 。 其 中 ， 图 7-4 所 示 为 点 击 “ 首 页 ”标签 按 
钮 时 的 截图 ， 图 7-5 所 示 为 点 击 “ 分 类 ”标签 按钮 时 的 截图 。 








我 是 首页 页面， 来 自 TabHostActivity 我 是 分 类 页 面 ， 来 自 TabHostActivity 


会 


分 类 





图 7-4 点 击 “ 首 页 ”标签 按钮 图 7-5 点 击 “ 分 类 ”标签 按钮 
2. 基于 ActivityGroup 的 标签 栏 


顾名思义 ，ActivityGroup 就 是 Activity 的 组 合 ， 允 许 在 内 部 开启 活动 页 面 。 从 这 个 意义 上 
来 说 , ActivityGroup 与 Activity 的 关系 相当 于 Activity 与 Fragment 的 关系 。 使 用 ActivityGroup 
实现 标签 栏 也 有 固定 的 模板 ， 该 方式 的 布局 文件 与 TabActivity 方式 相 比 ， 主 要 有 三 处 改动 : 


(1) 根 布局 节点 不 再 采用 TabHost， 改 为 使 用 常见 的 线性 布局 LinearLayout; 
(2) 删除 了 例行公事 的 选项 部 件 TabWidget; 
(3) 内 容 页 面 由 固定 编号 的 框架 布局 改 成 自 定义 编号 的 线性 布局 ， 示 例如 下 : 


<!-- 内 容 页 面 都 挂 在 这 个 线性 布局 下 面 --> 

<LinearLayout 
android:id="(@+id/ll_container" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="1" 
android:gravity="bottom|center" 
android:orientation="horizontal" /> 


至 于 ActivityGroup 方式 的 页 面 代码 ， 则 变化 集中 在 如 何 切 换 标签 页 ， 相 关 代 码 片 段 如 下 : 


// 内 容 视 图 改 为 展示 指定 的 视图 
private void changeContainerView(View v) { 
1_first.setSelected(false); / 取消 选中 第 一 个 标签 
1L_second.setSelected(false); / 取消 选中 第 二 个 标签 
1L_third.setSelected(false); / 取消 选中 第 三 个 标签 
vsetSelected(tmue); / 选中 指定 标签 
if (vl first) { 
// 切换 到 第 一 个 活动 页 面 TabFirstActivity 
toActivity("first", TabFirstActivity.class); 
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} elseif(v 一 1Lsecond) { 
// 切换 到 第 二 个 活动 页 面 TabSecondActivity 
toActivity("second", TabSecondActivity.class); 
} elseif (Vv— 1l third) { 
// 切换 到 第 三 个 活动 页 面 TabThirdActivity 
toActivity("third", TabThirdActivity.class); 


b 


// 把 内 容 视 图 切换 到 对 应 的 Activity 活动 页 面 


private void toActivity(String label, Class<?> cls) { 


/ 创建 一 个 意图 ， 并 存 入 指定 包 囊 
Intent intent = new Intent(this, cls).putExtras(mBundle); 
/ 移 除 内 容 框架 下 面 的 所 有 下 级 视图 
ll_container.removeAllViews(); 
// 启动 意图 指向 的 活动 ， 并 获取 该 活动 页 面 的 顶层 视图 
View v = getLocalActivityManager().startActivity(label, intent).getDecorView(); 
/ 设置 内 容 视图 的 布局 参数 
Vv.setLayoutParams(new LayoutParams( 
LayoutParams.MATCH PARENT, LayoutParams.MATCH PARENT)); 
/ 把 活动 页 面 的 顶层 视图 〈 即 内 容 视图 ) 添加 到 内 容 框架 上 


1L_containeraddView(v); 


} 


该 方式 的 核心 是 toActivity 函数 ， 方 法 内 部 可 设置 标签 按钮 的 文本 、 图 标 以 及 该 标签 对 应 
的 活动 页 面 。 从 函数 中 可 以 看 到 ，startActivity 方法 返回 一 个 Window 对 象 , 然后 从 该 Window 
对 象 提取 标签 页 的 实际 视图 (调用 getDecorView 方法 ) 。 读 者 不 妨 把 DecorView 理解 为 该 标 
签 页 的 根 视图 ， 那 么 代码 就 是 将 这 个 根 视图 DecorView 加 入 ActivityGroup 的 视图 容器 中 。 注 


意 , 这 里 在 调用 startA 


ctivity 方法 前 需要 先 调 用 getLocalActivityManager 方法 获得 页 面 管理 器 ， 


才能 进行 后 续 操作 ，getLocalActivityManager 方法 是 ActivityGroup 特有 的 函数 。 
该 方式 的 标签 栏 页 面 效果 与 TabActivity 一 样 。 为 了 区 分 两 种 方式 ， 这 里 在 具体 标签 页 中 
把 来 源 打 印 出 来 ， 如 图 7-6 和 图 7-7 所 示 。 其 中 ， 图 7-6 所 示 为 点 击 “ 首 页 ”标签 按钮 时 的 截 





图 ， 图 7-7 所 示 为 点 寺 


二 “购物 车 ”标签 按钮 时 的 截图 。 








我 是 首页 页 面 ， 来 自 TabGroupActivity 我 是 购物 车 页 面 ， 来 自 TabGroupActivity 
2 L 
首页 EE 购物 车 
图 7-6 点 击 “ 首 页 ”标签 按钮 图 7-7 点击“ 购物 车 ”标签 按钮 
3. 基于 FragmentActivity 的 标签 栏 


前 面 提 到 ，ActivityGroup 方式 采用 一 个 ActivityGroup 对 应 多 个 Activity 的 做 法 ， 那 么 也 
可 以 采取 一 个 Activity 对 应 多 个 Fragment 的 做 法 , 基于 FragmentActivity 的 标签 栏 就 是 该 思路 
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的 第 3 种 方式 。 与 前 两 种 方式 一 样 ，FragmentActivity 也 有 固定 的 使 用 模板 ， 下 面 是 该 方式 的 
布局 文件 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_ width="match_parent" 
android:layout_height="match parent" 
android:orientation= "vertical"> 


<!-- 这 是 实际 的 内 容 框 架 ， 内 容 页 面 都 挂 在 这 个 框架 布局 下 面 。 

把 FragmentLayout 放 在 FragmentTabHost 上 面 ， 标 签 栏 就 在 页 面 底部 ; 

反之 FragmentLayout 在 FragmentTabHost 下 面 ， 标 签 栏 就 在 页 面 顶部 。 -> 
<FrameLayout 

android:id="(@+id/realtabcontent" 

android:layout_width="match_parent" 

android:layout_height="0dp" 

android:layout_ weight="1" /> 


<!-- 碎片 标签 栏 的 id 必须 是 @android:id/tabhost --> 

<android.support.v4.app.FragmentTabHost 
android:id="(@android:id/tabhost" 
android:layout_width="match_parent" 
android:layout_height="(@dimen/tabbar_height"> 


<!-- 这 是 例行公事 的 选项 内 容 ， 实 际 看 不 到 -> 
<FrameLayout 
android:id="(@android:id/tabcontent" 
android:layout_width="0dp" 
android:layout_height="0dp" 
android:layout_weight="0" /> 
</android.support.v4.app.FragmentTabHost> 
</LinearLayout> 


看 起 来 布局 文件 简洁 了 许多 ， 该 方式 的 代码 也 同样 简洁 明了 : 
public class TabFragmentActivity extends AppCompatActivity { 


private static final String TAG = "TabFragmentActivity"; 
private FragmentTabHost tabHost; / 声明 一 个 碎片 标签 栏 对 象 


(@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_tab_fragment); 
Bundle bundle = new Bundle0; / 创建 一 个 包 圳 对 象 
bundle.putString("tag" TAG); // 往 包 衷 中 存 入 名 叫 tag 的 标记 
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/ 从 布局 文件 中 获取 名 叫 tabhost 的 碎片 标签 栏 

tabHost = findViewById(android.R.id.tabhost); 

/ 把 实际 的 内 容 框 架 安装 到 碎片 标签 栏 

tabHost.setup(this, getSupportFragment Manager(), R.id.realtabcontent); 

// 往 标签 栏 添加 第 一 个 标签 ， 其 中 内 容 视图 展示 TabFirstFragment 

tabHost.addTab(getTabView(R.string.menu_ first, R.drawable.tab_first_selector), 
TabFirstFragment.class, bundle); 

/ 往 标签 栏 添加 第 二 个 标签 ， 其 中 内 容 视 图 展示 TabSecondFragment 

tabHost.addTab(getTabView(R.string.menu_second, R.drawable.tab_second_selector), 
TabSecondFragment.class, bundle); 

// 往 标签 栏 添加 第 三 个 标签 ， 其 中 内 容 视图 展示 TabThirdFragment 

tabHostaddTab(getTabView(R.string.menu_third, R.drawable.tab_third_selector), 
TabThirdFragment.class, bundle); 

/ 不 显示 各 标签 之 间 的 分 隔 线 

tabHost.getTab Widget().set ShowDividers(LinearLayout.SHOW_DIVIDER_NONE); 

’ 


// 根据 字符 串 和 图 标的 资源 编号 ， 获 得 对 应 的 标签 规格 
private TabSpec getTabView(int textId, int imgId) { 
/ 根据 资源 编号 获得 字符 串 对 象 
String text = getResources().getString(textId); 
/ 根据 资源 编号 获得 图 形 对 象 
Drawable drawable = getResources(0.getDrawable(imgId); 
/ 设置 图 形 的 四 周边 界 。 这 里 必须 设置 图 片 大 小 ， 否 则 无 法 显示 图 标 
drawable.setBounds(0, 0, drawable.getMinimum Width(), drawable.getMinimumHeightO); 
/ 根据 布局 文件 item_tabbar.xml 生成 标签 按钮 对 象 
View item_tabbar = getLayoutInflater().inflate(R.layout.item_tabbar, null); 
TextView tv_item = item_tabbarfindViewById(R.id.tv_item_tabbar); 
tv_item.setText(text); 
/ 在 文字 上 方 显示 标签 的 图 标 
tv_item.setCompoundDrawables(null, drawable, null, null); 
// 生成 并 返回 该 标签 按钮 对 应 的 标签 规格 
return tabHost.newTabSpec(text).setIndicator(item_tabbar); 


} 

FragmentActivity 方式 的 核心 是 addTab 函数 , 内 部 可 自 定义 每 个 标签 按钮 的 视图 和 对 应 的 
Fragment 页 面 。 因 为 FragmentTabHost 已 经 自动 处 理 了 点 击 事件 ,所 以 无 须 另外 调用 setSelected 
方法 。 该 方式 与 前 两 种 方式 的 不 同 之 处 在 于 标签 页 是 Fragment 而 不 是 Activity, 因此 标签 页 内 
部 无 法 直接 操作 选项 菜单 。 

FragmentActivity 方式 的 标签 栏 与 前 两 种 方式 在 形式 上 没什么 差别 ， 具 体 效果 如 图 7-8 和 
图 7-9 所 示 。 其 中 ， 图 7-8 所 示 为 点 击 “ 分 类 ”标签 按钮 时 的 截图 ， 图 7-9 所 示 为 点 击 “ 购 物 
车 ”标签 按钮 时 的 截图 。 
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我 是 分 类 页 面 ， 来 自 TabFragmentActivity 我 是 购物 车 页 面 ， 来 自 TabFragmentActivity 
会 - 区 
分 类 物 革 E 入 购物 车 
图 7-8 点 击 “ 分 类 ”标签 按钮 图 7-9 点击 “购物 车 ”标签 按钮 


7.2 导 航 栏 


本 车 介绍 导航 栏 的 组 成 控件 ， 包 括 工具 栏 Toolbar、 溢 出 菜单 OverflowMenu、 搜 索 框 
SearchView、 标 签 布局 TabLayout 的 相关 用 法 ， 以 及 如 何 定制 Toolbar 的 视图 与 TabLayout 的 
标签 页 。 

7.2.1 工具 栏 Toolbar 


主流 App 除了 底部 有 一 排 标签 栏 外 ， 通 常 项 部 还 有 一 排 导航 栏 。 在 Android 5.0 之 前 ， 这 
个 顶部 导航 栏 以 ActionBar 控件 的 形式 出 现 ， 但 ActionBar 存在 不 灵活 、 难 以 扩展 等 毛病 ， 所 
以 Android 5.0 之 后 推出 了 Toolbar 工具 栏 控件 ， 意 在 取代 ActionBar。 

不 过 为 了 兼容 之 前 的 版 本 ，ActionBar 控件 仍然 保留 。Toolbar 与 ActionBar 都 占 着 顶部 导 
航 栏 的 位 置 ， 要 想 引 入 Toolbar 就 得 先 关闭 ActionBar。 有 具体 的 操作 步骤 如 下 : 

人 ERO) 在 stylesxml 中 定义 一 个 不 包含 ActionBar 的 风格 样式 ， 代 码 如 下 : 

<style name="AppCompatTheme" parent="Theme.AppCompat.Light.NoActionBar" /> 

02 修改 AndroidManifestxml， 把 activity 节点 的 android:theme 属性 值 改 为 第 一 步 定 义 的 风 
格 ， 如 android:theme="@style/AppCompatTheme"。 

人 63 将 页 面 布局 文件 的 根 节点 改 为 LinearLayout， 且 为 vertical 垂直 方向 ， 然 后 增加 一 个 
Toolbar 元 素 ， 因 为 Toolbar 本 质 是 一 个 ViewGroup， 所 以 也 可 以 在 下 面 添 加 别 的 控件 。 下 面 是 一 个 布 
局 文件 的 片段 : 

<android.support.v7.widget.Toolbar 
android:id="@+id/tL head" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" /> 

04 将 Activity 代码 改 为 继承 自 AppCompatActivity, 其 实在 Android Studio 中 新 建 模块 已 经 
是 默认 继承 AppCompatActivity 了 。 然 后 在 onCreate 函数 中 获取 布局 文件 中 的 Toolbar 对 象 ， 并 调 
setSupportActionBar 方法 设置 当前 的 Toolbar 对 象 。 


Toolbar 之 所 以 比 ActionBar 灵活 ， 原 因 是 Toolbar 提供 了 多 个 属性 指定 控件 风格 。Toolbar 
的 常用 属性 及 设置 方法 见 表 7-1( 自 定义 属性 的 用 法 参见 第 6 章 的 “6.1.1 声明 属性 ”) 。 
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表 7-1 Toolbar 的 常用 属性 及 设置 方法 说 明 



































XML 中 的 属性 Toolbar 类 的 设置 方法 说 明 

Logo setLogo 设置 工具 栏 图 标 

Title setTitle 设置 标题 文字 

titleTextColor setTitleTextColor 设置 标题 的 文字 颜色 

titleTextAppearance setTitleTextAppearance 设置 标题 的 文字 风格 。 风 格 定义 在 styles.xml 中 
subtitle setSubtitle 设置 副标题 文字 。 副 标题 在 标题 下 方 
subtitleTextColor setSubtitleTextColor 设置 副标题 的 文字 颜色 

subtitleTextAppearance setSubtitleTextAppearance 设置 副标题 的 文字 风格 

navigationIcon setNavigationIcon 设置 左 侧 导航 图 标 

无 setNavigationOnClickListener ”| 设置 导航 图 标的 点 击 监听 器 


下 面 是 使 用 Toolbar 的 代码 片段 : 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_toolbar); 


1/ 从 布局 文件 中 获取 名 叫 tl_head 的 工具 栏 
Toolbar tl head = findViewById(R.id.tL_head); 
/ 设置 工具 栏 左边 的 导航 图 标 
tl_ head.setNavigationIcon(R.drawable.ic_back); 
/ 设置 工具 栏 的 标题 文本 
tL_head.setTitle(" 工 具 栏 页 面 "); 
/ 设置 工具 栏 的 标题 文字 颜色 
tl head.setTitleTextColor(Color.RED); 
/ 设置 工具 栏 的 标志 图 片 
tl head.setLogo(R.drawable.ic_app); 
/ 设置 工具 栏 的 副标题 文本 
tl head.setSubtitle("Toolbar"); 
/ 设置 工具 栏 的 副标题 文字 颜色 
tl head.setSubtitleTextColor(Color.YELLOW); 
/ 设置 工具 栏 的 背景 
tl head.setBackgroundResource(R.color.blue_light); 
/ 使 用 tl_head 替换 系统 自 带 的 ActionBar 
setSupportActionBar(tl head); 
/ 给 tL_head 设置 导航 图 标的 点 击 监听 器 
// setNavigationOnClickListener 必须 放 到 setSupportActionBar 之 后 ， 不 然 不 起 作用 
tl_ head.setNavigationOnClickListener(new OnClickListenerO { 
@Overide 
public void onClick(View view) { 


finish(); / 结束 当前 页 面 


D; 
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} 
具体 的 工具 栏 效果 如 图 7-10 所 示 ， 该 工具 栏 的 界面 “” 属 一 
元 素 包 括 导航 图 标 、 工 具 栏 图 标 、 标 题 、 副 标题 。 该 页 面 责 示 工具 栏 功能 








7.2.2 溢出 菜单 OverflowMenu 


图 7-10 简单 设置 后 的 工具 栏 界 面 
导航 栏 右边 往往 有 个 三 点 图 标 ， 点 击 后 会 弹出 菜单 。 这 个 右上 角 的 弹出 菜单 名 叫 溢出 菜 
单 OverflowMenu, 意 指导 航 栏 不 够 放 了 、 溢 出 来 了 。 洲 出 菜单 其 实 就 是 把 选项 菜单 OptionsMenu 
搬 到 了 页 面 右上 方 ， 具 体 的 菜单 布局 与 代码 用 法 基本 同 选项 菜单 ， 不 同 之 处 在 于 溢出 菜单 多 了 
个 showAsAction 属性 ,该 属性 用 来 控制 菜单 项 在 导航 栏 上 的 展示 位 置 ,具体 的 取 值 说 明 见 表 7-2。 








表 7-2 菜单 项 展示 位 置 类 型 的 取 值 说 明 











展示 位 置 类 型 说 明 

always 总 是 在 导航 栏 上 显示 菜单 图 标 

ifRoom 如 果 导 航 栏 右 侧 有 空间 ， 该 项 就 直接 显示 在 导航 栏 上 ， 不 再 放 入 溢出 菜单 

never 从 不 在 导航 栏 上 直接 显示 ， 一 直 放 在 溢出 菜单 列表 里 面 

withText 如 果 能 在 导航 栏 上 显示 ， 除 了 显示 图 标 ， 还 要 显示 该 项 的 文字 说 明 
collapseActionView ”| 操作 视图 要 折 芝 为 一 个 按钮 ， 点 击 该 按钮 再 展开 操作 视图 ， 主 要 用 于 SearchView 


默认 情况 下 ， 菜 单列 表 的 菜单 项 不 会 在 文字 左边 显示 图 标 ， 即 使 在 菜单 布局 中 设置 了 icon 
属性 也 没有 作用 。 所 以 想 让 菜单 项 显示 左 侧 图 标 就 得 调用 MenuBuilder 的 setOptionallconsVisible 
方法 。 该 方法 是 一 个 隐藏 方法 ， 只 能 通过 反射 机 制 调用 。 具 体 的 调用 代码 如 下 : 
public static void setOverflowIconVisible(int featureld, Menu menu) { 
// ActionBar 的 featureld 是 8，Toolbar 的 featureld 是 108 
if (featureld % 100 =— Window.FEATURE ACTION BAR && menu (= null) { 
if (menu.getClass(.getSimpleName().equals("MenuBuilder")) { 
try{ 
// setOptionallconsVisible 是 个 隐藏 方 法 ， 需 要 通过 反射 机 制 调用 
Method m = menu.getClass().getDeclaredMethod( 
"setOptionallconsVisible", Boolean.TYPE); 
m.setAccessible(true); 
m.invoke(menu, true); 
} catch (Exception e) { 
©.printStack Trace(); 
上 


} 
另外 ， 菜 单 布局 中 将 showAsAction 属性 设置 为 ifRoom 或 always， 不 过 即使 工具 栏 上 还 
有 空间 ， 该 菜单 项 也 不 会 显示 在 工具 栏 上。 这 方面 也 很 不 好 ， 因 为 在 ActionBar 时 代 ， 这 么 做 
没 问题 ， 到 Toolbar 时 代 反 而 出 了 问题 。 既 然 有 问题 就 得 解决 ， 解 决 办 法 挺 简单 ， 首 先 在 菜单 
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布局 的 menu 根 节点 增加 命名 空间 声明 xmlns:app="http://schemas.android.com/apk/res-auto", 然 
后 把 android:showAsAction="ifRoom" 改 为 app:showAsAction="ifRoom"。 很 眼熟 是 不 是 ? 这 分 
明 就 是 自 定 义 属性 的 做 法 。 下 面 来 看 用 于 溢出 菜单 的 布局 文件 代码 : 


<menu xmins:android="http://schemas.android.comyapky/res/android" 


xmins:app="http://schemas.android.com/apk/res-auto" > 


<item 


android:id="(@+id/menu_refresh" 
android:orderInCategory="1" 
android:icon="(@drawable/ic_refresh" 
app:showAsAction="ifRoom" 
android:title=" 刷 新 "/> 


<item 


android:id="(@+id/menu_about" 
android:orderInCategory="8" 
android:icon="(@drawable/ic_about" 
app:showAsAction="never" 
android:title=" 关 于 "/> 


<item 


</menu> 


android:id="(@+id/menu_quit" 
android:orderInCategory="9" 
android:icon="(@drawable/ic_quit" 
app:showAsAction="never" 
android:title=" 退 出 "/> 


下 面 是 在 页 面 代码 中 操作 溢出 菜单 的 代码 片段 : 


@Override 
public boolean onMenuOpened(int featureld, Menu menu) { 


/ 显示 菜单 项 左 侧 的 图 标 
MenuUtil.setOverflowIconVisible(featureld, menu); 
return super.onMenuOpened(featureld, menu); 


@Override 
public boolean onCreateOptionsMenu(Menu menu) { 


// 从 menu_overflow.xml 中 构建 菜单 界面 布局 
getMenulnflater().inflate(R.menu.menu_overflow, menu); 
return true; 


@Override 
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public boolean onOptionsItemSelected(Menultem item) { 

int id = item.getItemId(); 

让 (id == android.R.id.home) { // 点 击 了 工具 栏 左边 的 返回 箭头 
finish(); 

} elseif id == R.id.menu refresh) { / 点 击 了 刷新 图 标 
tv_desc.setText(" 当 前 刷新 时 间 : "+ DateUtil.getNowDateTime("yyyy-MM-dd HH:mm:ss")); 
return true; 

}else if id == R.id.menu about) { // 点 击 了 关于 菜单 项 
Toast.makeText(this, "这 个 是 工具 栏 的 演示 demo", Toast.LENGTH_LONG).show0; 
return true; 

}elseif(id==R.id.menu quit) { // 点 击 了 退出 菜单 项 
finish(); 

} 

return super.onOptionsItemSelected(item); 


上 
添加 溢出 菜单 后 的 导航 栏 效果 如 图 7-11 和 图 7-12 所 示 。 其 中 ， 图 7-11 所 示 为 导航 栏 的 
初始 界面 ， 此 时 导航 栏 右 侧 有 一 个 刷新 按钮 ， 还 有 一 个 三 点 图 标 ; 点 击 三 点 图 标 ， 弹 出 剩余 的 
菜单 项 列表 ， 如 图 7-12 所 示 。 


《< ”溢出 菜单 页 面 


该 页 面 演示 溢出 菜单 功能 





图 7-11 溢出 菜单 初始 界面 图 7-12 点 击 按钮 弹出 菜单 列表 
7.2.3 搜索 框 SearchView 


导航 栏 中 间 往 往 有 个 搜索 框 ， 特 别 是 电 商 App 的 导航 栏 ， 搜 索 框 是 标 配 。 在 工具 栏 上 添 
加 并 使 用 搜索 框 有 些 复 杂 ， 实 现 步骤 大 致 如 下 : 
CLTIO1 在 菜单 布局 文件 中 定义 搜索 项 ， 示 例 代码 如 下 : 
<item 

android:id="(@+id/menu_search" 
android:orderInCategory="1" 
android:icon="(@drawable/ic_search" 
app:showAsAction="ifRoom" 
android:title=" 搜 索 " 
app:actionViewClass="android.support.v7.widget.SearchView" > 


E302 在 resxml 目录 下 新 建 searchable.xml， 设 置 搜索 框 的 样式 代码 ， 举 例如 下 : 


<searchable xmlns:android="http://schemas.android.com/apk/res/android" 
android:label="(@string/app_name" 
android:hint="(@string/please_input" 
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android:inputType="text" 
android:searchButtonText="(@string/search" /> 
人 3 在 AndroidManifest.xml 中 加 入 一 个 搜索 结果 页 面 的 activity 节点 定义 ， 需 要 指定 action 
和 meta-data， 举 例如 下 : 














<activity android:name=".SearchResultActvity" android:theme="(@style/AppCompatTheme" > 
<intent-filter> 
<action android:name="android.intent.action.SEARCH"/> 
</intent-filter> 
<meta-data android:name="android.app.searchable" android:resource="@xml/searchable"/> 
</activity> 


C04 在 Activity 代码 中 初始 化 搜索 框 ， 并 关联 搜索 动作 对 应 的 结果 Activity ， 如 
SearchResultActvity。 代 码 片段 如 下 : 


private SearchView.SearchAutoComplete sac_key; / 声明 一 个 搜索 自动 完成 的 编辑 框 对 象 


private String[] hintArray = {"iphone", "iphone8", "iphone8 plus", "iphone7", "iphone7 plus"}; 


/ 根据 菜单 项 初始 化 搜索 框 

Private void initSearchView(Menu menu) { 
Menultem menultem = menu.findItem(R.id.menu_search); 
/ 从 菜单 项 中 获取 搜索 框 对 象 
SearchView searchView = (SearchView) menultem.getActionView(); 
/ 设置 搜索 框 默 认 自 动 缩小 为 图 标 
searchView.setIconiffiedByDefault(getImtent().getBooleanExtra("collapse", true)); 
/ 设置 是 否 显示 搜索 按钮 。 搜 索 按钮 只 显示 一 个 箭头 图 标 ，Android 暂 不 支持 显示 文本 。 
/ 查看 Android 源码 ， 搜 索 按钮 用 的 控件 是 ImageView， 所 以 只 能 显示 图 标 不 能 显示 文字 。 
searchView.setSubmitButtonEnabled(true); 
/ 从 系统 服务 中 获取 搜索 管理 器 
SearchManager sm = (SearchManager) getSystemService(ContextSEARCH SERVICE); 
/ 创建 搜索 结果 页 面 的 组 件 名 称 对 象 
ComponentName cn = new ComponentName(this, SearchResultActvity.class); 
/ 从 结果 页 面 注册 的 activity 节点 获取 相关 搜索 信息 ， 即 searchable.xml 定义 的 搜索 控件 
SearchableInfo info = sm.getSearchableInfo(cn); 
/ 设置 搜索 框 的 可 搜索 信息 
searchView.setSearchableInfo(info); 
// 从 搜索 框 中 获取 名 叫 search_src_text 的 自动 完成 编辑 框 
Sac_key = searchView.findViewById(R.id.search_src_text); 
/ 设置 自动 完成 编辑 框 的 文本 颜色 
Sac_key.setTextColor(Color WHITE): 
/ 设置 自动 完成 编辑 框 的 提示 文本 颜色 
Sac_key.setHintTextColor(Color WHITE); 
/ 给 搜索 框 设置 文本 变化 监听 器 
searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() { 
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// 搜索 关键 词 完成 输入 

public boolean onQueryTextSubmit(String query) { 
Teturn false; 

} 


/ 搜索 关键 词 发 生变 化 
public boolean onQueryTextChange(String newText) { 
doSearch(newText); 
return true; 
} 
D; 
Bundle bundle = new Bundle(); / 创建 一 个 新 包 囊 
bundle.putString("hi", "hello"); / 往 包 庄 中 存放 名 叫 hi 的 字符 串 
/ 设置 搜索 框 的 额外 搜索 数据 
searchView.setAppSearchData(bundle); 
; 


// 自动 匹配 相关 的 关键 词 列表 
private void doSearch(String text) { 
if (text.indexOf("i") == 0) { 
/ 根据 提示 词 数 组 构建 一 个 数组 适配器 
ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, 
R.layoutsearch_list_auto, hintArray); 
/ 设置 自动 完成 编辑 框 的 数组 适配器 
sac_key.setAdapter(adapter); 
// 给 自动 完成 编辑 框 设置 列表 项 的 点 击 监听 器 
sac_key.setOnItemClickListener(new OnltemClickListener() { 
/ 一 旦 点 击 关键 词 匹配 列表 中 的 某 一 项 ， 就 触发 点 击 监听 器 的 onltemClick 方法 
public void onItemClick(AdapterView<?> parent View view, int position, long id) { 
sac key.setText(((TextView) view).getText()); 
D); 


bi 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
/ 从 menu_search.xml 中 构建 菜单 界面 布局 
getMenulnflater().inflate(R.menu.menu_search, menu); 
/ 初始 化 搜索 框 
initSearchView(menu); 
return true; 


第 7 章 组 合 控件 | 253 





C05 编写 搜索 结果 页 面 的 Activity 代码 ， 获 取 关 键 字 的 代码 片段 如 下 : 


// 解析 搜索 请 求 页 面 传 来 的 搜索 信息 ， 并 据 此 执行 搜索 查询 操作 
private void doSearchQuery(Intent intent) { 
让 (intent !=nulD) { 
// 如 果 是 通过 ACTION_SEARCH 来 调用 ， 即 为 搜索 框 来 源 
if (Intent. ACTION_SEARCH.equals(intent.getAction|)) { 
/ 获取 额外 的 搜索 数据 
Bundle bundle = intent.getBundleExtra(SearchManager.APP_DATA): 
String value = bundle.getString("hi"); 
/ 获取 实际 的 搜索 文本 
String queryString = intent.getStringExtra(SearchManager.QUERY); 
tv_search_result.setText(" 您 输入 的 搜索 文字 是 :"+queryString+", 额外 信息 : "+value); 


搜索 框 的 使 用 效果 如 图 7-13 一 图 7-16 所 示 。 其 中 ， 图 7-13 所 示 为 导航 栏 的 初始 界面 ; 图 
7-14 为 点 击 搜索 图 标 后 ， 展 开 搜索 视图 的 界面 ， 图 7-15 所 示 为 输入 搜索 文字 后 ， 弹 出 关键 词 
列表 的 界面 ， 图 7-16 所 示 为 点 击 完成 按钮 ， 跳 转 到 搜索 结果 页 面 的 截图 。 






请 输入 
该 页 面 演示 搜索 框 功 能 


图 7-14 ”展开 搜索 框 的 页 面 


该 页 面 演示 搜 叶 iphone7s 此 输入 的 搜索 文字 是 : iphone7s, 额外 信息 : hello 
iphone7 


iphone7 plus 


7-15 ”输入 关键 字 弹 出 选择 列表 图 7-16 搜索 结果 页 面 的 截图 
7.2.4 标签 布局 TabLayout 


Toolbar 作为 ActionBar 的 升级 版 ， 好 处 在 于 允许 设置 内 部 控件 的 样式 ， 还 允许 添加 其 他 
外 部 控件 。 第 6 章 的 实战 项 目 “ 手 机 安全 助手 流量 主页 面 的 顶部 是 一 个 自己 做 的 简单 导航 栏 ， 
该 导航 栏 的 主 节点 是 LinearLayout， 现 在 我 们 把 LinearLayout 换 成 Toolbar， 相 当 于 系统 默认 
实现 左 侧 的 导航 图 标 和 右 侧 的 溢出 菜单 ， 中 间 的 部 分 是 开发 者 要 添加 的 视图 。 
下 面 是 修改 后 的 布局 文件 片段 ， 此 时 Toolbar 节点 可 以 当 作 LinearLayout 节点 使 用 : 
<android.support.v7.widget.Toolbar 
android:id="(@+id/tl_head" 
android:layout_width="match_parent" 
android:layout_height="50dp" 


android:background="(@color/blue light" 
app:navigationIcon="(@drawable/ic_back"> 


<!-- Toolbar 下 面 允 许 添加 自 定义 的 布局 内 容 --> 

<RelativeLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" > 


<TextView 
android:id="(@-+id/tv_day" 
android:layout_width="wrap_content" 
android:layout_height="match_parent" 
android:layout_centerInParent="true" 
android:background="(@drawable/editext_selector" 
android:gravity="center" 
android:textColor="(@color/black" 
android:textSize="17sp" /> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="match_parent" 
android:layout_toLeftOf="(@+id/tv_day" 
android:gravity="center" 
android:text=" 统 计 日 期 " 
android:textColor="(@color/black" 
android:textSize="17sp" /> 
</RelativeLayout> 
</android.support.v7.widget.Toolbar> 


修改 后 的 导航 栏 效果 如 图 7-17 所 示 , 中 部 原来 展 
示 标题 的 位 置 变 成 展示 统计 日 期 了 。 

如 果 定 制 Toolbar 仅仅 放 入 几 个 基本 控件 ， 就 太 
小 儿科 了 ， 这 么 好 的 工具 栏 ， 必 须 有 杀手 级 别 的 控件 
搭配 。 下 面 先 看 京东 App 的 两 张 截图 , 图 7-18 是 商品 图 7-17 定制 修改 后 的 导航 栏 
页 面 ， 图 7-19 是 详情 页 面 ， 这 两 个 页 面 之 间 通 过 左右 滑动 切换 。 导 航 栏 上 有 文字 标签 ， 类 似 
于 翻 页 标题 栏 PagerTabStrip， 用 于 指示 当前 滑 到 了 哪个 页 面 。 


统计 
目 期 2018 年 05 月 23 晶 


& 


该 页 面 演示 工具 栏 定制 样式 


(全 王 : 
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售后 服务 说 明 
已 数 活 的 Apple 笔记 本 、 台 式 机 无 质量 问题 不 支持 七 天 无 理由 退换 货 ， 
请 您 确认 需求 后 再 者 活 使 用 











% MacBook Air 














图 7-18 京东 的 商品 页 面 截 图 图 7-19 京东 的 详情 页 面 截图 
通过 工具 栏 控制 页 面 左右 滑动 的 用 户 体验 挺 不 错 ， 这 里 压轴 用 的 便 是 design 库 中 的 标签 
布局 TabLayout， 使 用 该 控件 前 要 先 修改 build.gradle， 在 dependencies 节点 中 加 入 一 行 代 码 表 
示 导 入 design 库 : 


implementation 'com.android.support:design:28.0.0” 


TabLayout 的 展现 形式 类 似 于 PagerTabStrip ， 同 样 是 文字 标签 带 下 划 线 ， 不 同 的 是 
TabLayonut 允许 定制 更 丰富 的 样式 ， 新 增 的 样式 属性 主要 有 以 下 6 种 。 


tabBackground: 指定 标签 的 背景 。 
tabIndicatorColor: 指定 下 划 线 的 颜色 。 
tabIndicatorHeight: 指定 下 划 线 的 高 度 。 
tabTextColor: 指定 标签 文字 的 颜色 。 
tabTextAppearance: 指定 标签 文字 的 风格 。 
tabSelectedTextColor: 指定 选中 文字 的 颜色 。 
下 面 是 在 XML 文件 中 使 用 TabLayout 的 布局 内 容 片 段 : 
<android.support.v7.widget.Toolbar 
android:id="@+id/tl_head" 
android:layout_width="match_parent" 
android:layout_height="$0dp" 
app:navigationIcon="(@drawable/ic_back"> 





© 0 0 0 0 9。 


<RelativeLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<!-- 注意 TabLayout 节点 需要 使 用 完整 路 径 --> 
<android.support.design.widget.TabLayout 
android:id="@+id/tab_title" 


256 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


android:layout width="wrap_content" 
android:layout_ height="match parent" 
android:layout_centerInParent="true" 
app:tabIndicatorColor="(@color/red" 
app:tabIndicatorHeight="2dp" 
app:tabSelectedTextColor="(@color/red" 
app:tabTextColor="(@color/grey" 
app:tabTextAppearance="(@style/TabText" /> 
</RelativeLayout> 
</android.support.v7.widget.Toolbar> 


在 代码 中 ，TabLayout 通过 以 下 4 种 方法 操作 标签 。 


e@ newTab: 创建 新 标签 。 

e addTab: 添加 一 个 标签 。 

e getTabAt: 获取 指定 位 置 的 标签 。 

e@ ”setOnTabSelectedListener: 设置 标签 的 选中 监听 器 .该 监听 器 需 实 现 OnTabSelectedListener 
接口 的 3 个 方法 。 


> onTabSelected: 标签 被 选中 时 触发 。 
> onTabUnselected: 标签 被 取消 选中 时 触发 。 
> onTabReselected: 标签 被 重新 选中 时 触发 。 


把 TabLayout 与 ViewPager 结合 起 来 就 是 一 个 固定 的 套路 , 使 用 时 直接 套 框 架 就 行 。 下 面 
是 两 者 联合 使 用 的 代码 片段 : 
private ViewPager vp_content; / 定义 一 个 翻 页 视图 对 象 


private TabLayout tab_title; / 定义 一 个 标签 布局 对 象 
Private ArrayList<String> mTitleArray = new ArrayList<String>(); / 标题 文字 队列 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_tab_layout); 
// 从 布局 文件 中 获取 名 叫 tL head 的 工具 栏 
Toolbar t| head = findViewById(R.id.tL_head); 
/ 使 用 tl_head 替换 系统 自 带 的 ActionBar 
setSupportActionBar(tl head); 
mTitleArray.add(" 商 品 "); 
mTitleArray.add(" 详 情 "); 
initTabLayout(); / 初始 化 标签 布局 
initTabViewPager0:; / 初始 化 标签 翻 页 


/ 初始 化 标签 布局 
private void initTabLayout() { 
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/ 从 布局 文件 中 获取 名 叫 tab title 的 标签 布局 
tab title = findViewBylId(R.id.tab title); 
/ 给 tab title 添加 一 个 指定 文字 的 标签 
tab_title.addTab(tab title.newTab().setText(mTitleArray.get(0))); 
/ 给 tab_title 添加 一 个 指定 文字 的 标签 
tab_title.addTab(tab title.newTab().setText(mTitleArray.get(1))); 
/ 给 tab_title 添加 标签 选中 监听 器 
tab_title.addOnTabSelectedListener(this); 

b 


/ 初始 化 标签 翻 页 
private void initTabViewPager() { 
// 从 布局 文件 中 获取 名 叫 vp_content 的 翻 页 视图 
vp_content = findViewById(R.id.vp_content); 
/ 构建 一 个 商品 信息 的 翻 页 适配器 
GoodsPagerAdapter adapter = new GoodsPagerAdapter( 
getSupportFragment Manager(), mTitleArray); 
/ 给 vp_content 设置 商品 翻 页 适配器 
Vvp_content.setAdapter(adapter); 
/ 给 vp_content 添加 页 面 变更 监听 器 
Vvp_content.addOnPageChangeListener(new SimpleOnPageChangeL istener() { 
(QOverride 
public void onPageSelected(int position) { 
// 选中 tab title 指定 位 置 的 标签 
tab_title.getTabAt(position).select(); 


1 


/ 在 标签 被 重复 选中 时 触发 
public void onTabReselected(Tab tab) {} 


/ 在 标签 选中 时 触发 
public void onTabSelected(Tab tab) { 
/ 让 vp_content 显示 指定 位 置 的 页 面 
Vvp_content.setCurrentItem(tab.getPosition()); 
}; 


/ 在 标签 取消 选中 时 触发 
public void onTabUnselected(Tab tab) {} 


接 下 来 看 在 工具 栏 上 显示 标签 页 的 效果 。 选 中 “商品 ”标签 ， 页 面 下 方 显示 商品 信息 文 
字 ， 如 图 7-20 所 示 ; 然后 选中 “详情 ”标签 ， 切 换 到 商品 详情 页 面 ， 如 图 7-21 所 示 。 感 觉 不 
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错 吧 ， 赶 快 动手 实践 一 下 ， 你 也 可 以 实现 京东 App 的 标签 导航 栏 。 
< 商品 “详情 (> 





Android Studio 








从 零 大 由 到 ApP 上 线 
Wt 
Android Studio 开 发 实战 Android Studio 开 发 实战 
从 零 基 础 到 App 上 线 从 零 基 础 到 App 上 线 


图 7-20 点 击 “商品 ”标签 图 7-21 点击“ 详情 ”标签 


TabLayout 默认 采用 文本 标签 ， 也 支持 自 定 义 标签 ， 除 了 放 文 本 还 可 以 放 图 像 ， 比 如 加 一 
个 角 标 。 自 定义 标签 的 过 程 很 简单 ,首先 要 定义 标签 项 的 布局 文件 。 下 面 是 一 个 布局 文件 的 例 
子 ， 其 中 包含 文本 控件 与 图 像 控 件 ， 并 且 TextView 的 textColor 属性 与 ImageView 的 src 属性 
都 采用 状态 图 形 ， 代 码 如 下 : 
<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<TextView 
android:id="@+id/tv_toolbarl" 
android:layout_width="wrap_content" 
android:layout_height="match_parent" 
android:layout_centerInParent="true" 
android:gravity="center" 
android:textColor="(@drawable/toolbar_text_selector" 
android:textSize="17sp" /> 


<ImageView 
android:id="(@+id/iv_point1" 
android:layout_width="25dp" 
android:layout_height="25dp" 
android:layout_toRightOf="(@+id/tv_toolbarl" 
android:paddingTop="10dp" 
android:paddingLeft="3dp" 
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android:scaleType="fitCenter" 
android:src="(@drawable/toolbar image selector" />" 
</RelativeLayout> 


然后 打开 活动 页 面 代 码 ， 只 要 修改 initTabLayout 函数 即 可 , 关键 是 调用 了 setCustomView 
方法 ， 变 更 的 代码 片段 如 下 : 


// 初始 化 标签 布局 

Private void initTabLayoutO) { 
1/ 从 布局 文件 中 获取 名 叫 tab_title 的 标签 布局 
tab_title = findViewById(R.id.tab_title); 
/ 给 tab_title 添加 一 个 指定 布局 的 标签 
tab_title.addTab(tab_title.newTab().setCustomView(R.layout.item_ toolbar])); 
TextView tv_toolbarl = findViewById(R.id.tv_toolbarl); 
tv_toolbarl.setText(mTitleArray.get(0)); 
/ 给 tab title 添加 一 个 指定 布局 的 标签 
tab_title.addTab(tab title.newTab().setCustomView(R.layout.item_toolbar2)); 
TextView tv_toolbar2 = findViewBylId(R.id.tv_toolbar2); 
tv_toolbar?2.setText(mTitleArray.get(1)); 
/ 给 tab_title 添加 标签 选中 监听 器 ， 该 监听 器 默认 绑 定 了 翻 页 视图 vp_content 
tab_title.addOnTabSelectedListener(new ViewPagerOnTabSelectedListener(vp_contenb); 


重新 编译 并 运行 App, 最 新 的 效果 如 图 7-22 和 图 7-23 所 示 。 其 中 , 图 7-22 所 示 为 点 击 “ 商 
品 ” 标 签 时 的 界面 ， 此 时 “商品 ”文字 右上 角 显示 红 点 ， 图 7-23 所 示 为 点 击 “ 详 情 ”标签 时 
的 界面 ， 此 时 “详情 ”文字 右上 角 显 示 红 点 。 








Android Studio 开 如 








从 零 相 础 到 App 上 线 
dm 一 
Android Studio 开 发 实战 Android Studio 开 发 实战 
从 零 基 础 到 App 上 线 从 零 基 础 到 App 上 线 








7-22 点击“ 商品 ”的 自 定义 标签 7-23 点击“ 详情 ”的 自 定义 标签 
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7.3 横幅 条 


本 节 介绍 横幅 条 Banner 的 两 种 展现 形式 与 具体 实现 , 包括 如 何在 Banner 底部 自 定义 可 以 
滚动 的 指示 器 、 如 何 实现 会 自动 轮 播 的 横幅 条 、 如 何 让 Banner 顶 到 上 面 的 状态 栏 。 同 时 还 会 
复习 自 定义 视图 和 自 定义 动画 的 知识 。 


7.3.1 自 定义 指示 器 


在 第 5 章 介绍 ViewPager 时 给 出 了 启动 引导 页 的 例子 ， 为 了 让 用 户 知道 当前 是 在 第 几 页 ， 
在 每 个 页 面 下 方 都 要 添加 一 排 圆 点 , 通过 高 亮 圆 点 指示 当前 的 页 面 位 置 ， 这 排 圆 点 我 们 称 之 为 
指示 器 。 引 导 页 里 的 指示 器 其 实 附着 在 每 个 Fragment 页 面 下 方 ， 而 不 是 固定 在 手机 屏幕 下 方 ， 
所 以 会 感觉 有 些 奇怪 。 理 想 的 情况 是 ， 引 导 页 在 滑动 时 屏幕 下 方 的 指示 器 固定 不 动 ， 高 亮 圆 点 
随 着 页 面 滑动 而 缓慢 挪动 ， 页 面 滑 到 下 一 页 ， 高 亮 圆 点 刚好 挪 到 下 一 个 圆 点 处 。 

这 么 说 可 能 有 些 抽象 ， 不 如 看 看 新 方式 的 效果 图 ， 如 图 7-24 所 示 。 当 前 翻 页 位 置 在 第 一 
页 和 第 二 页 之 前 , 此 时 底部 指示 器 的 高 亮 圆 点 刚好 挪 到 第 一 个 圆 点 与 第 二 个 圆 点 之 间 , 随 着 页 
面 的 滚动 ， 高 亮 圆 点 随 之 平滑 滚动 。 

















精 影 好 礼 等 你 来 


. MOB 


ee 
图 7-24 底部 滑动 着 的 高 亮 圆 点 


要 实现 指示 器 的 平滑 滚动 效果 ,得 用 到 ViewPager 的 页 面 变化 监听 器 OnPageChangeListener。 
第 5 章 介绍 该 监听 器 时 提 到 有 onPageScrollStateChanged、onPageScrolled、onPageSelected 三 个 
方法 ， 在 具体 场合 有 下 面 两 种 用 法 。 


1. 只 实现 onPageSelected 方法 ， 在 页 面 滚动 结束 时 触发 ， 该 用 法 是 最 常见 的 。 


在 这 种 情况 下 , onPageScrollStateChanged 和 onPageScrolled 两 个 方法 成 了 摆设 , 占 着 多 余 
的 代码 行 非常 浪费 。 此 时 不 必 完 整 实现 OnPageChangeListener 接口 ， 只 需 创 建 一 个 
SimpleOnPageChangeListener 实例 即 可 ， 该 内 部 类 在 ViewPager 源码 中 已 经 封装 好 了 ， 开 发 者 
只 要 实现 onPageSelected 方法 就 行 。 具 体 的 调用 代码 如 下 : 
// 给 翻 页 视图 添加 简单 的 页 面 变更 监听 器 ， 此 时 只 需 重 写 onPageSelected 方法 
vp_banner.addOnPageChangeListener(new SimpleOnPageChangeListener() { 
@Override 
public void onPageSelected(int position) { 
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/ 高 亮 显 示 该 位 置 的 指示 按钮 
setButton(position); 


DD); 


2. 除了 实现 onPageSelected 方法 ， 还 要 实现 onPageScrollStateChanged 和 
onPageScrolled 两 个 方法 。 


这 种 情况 适用 于 指示 器 ， 特 别 是 onPageScrolled 方法 的 参数 已 明确 指出 当前 的 滚动 进度 ， 
正好 给 指示 器 的 滚动 位 置 提 供 参考 。 接 下 来 的 工作 是 自 定义 一 个 指示 器 控件 , 首先 绘制 背景 图 
的 一 排 圆 点 ， 然 后 绘制 前 景 图 的 高 亮 圆 点 。 正 好 复习 一 下 第 6 章 自 定义 视图 的 技术 ， 读 者 可 自 
定义 实现 该 指示 器 控件 ， 下 面 是 该 控件 的 参考 代码 : 

public class PagerIndicator extends LinearLayout { 

private Context mContext; “// 声明 一 个 上 下 文 对 象 

private int mCount = 5; // 指示 器 的 个 数 

private int mPad; / 两 个 圆 点 之 间 的 间隔 

private int mSeq = 0， / 当前 指示 器 的 序号 

private float mRatio = 0.0f // 已 经 移动 的 距离 百分比 

private Paint mPaint; / 声明 一 个 画笔 对 象 

private Bitmap mBackImage; / 背景 位 图 ， 通 常 是 灰色 圆 点 
private Bitmap mForeImage; / 前 景 位 图 ， 通 常 是 高 亮 的 红色 圆 点 





public PagerIndicator(Context context) { 


this(context, null); 
’ 
public PagerIndicator(Context context, AttributeSet attrs) { 
super(context, attrs); 
mContext = context; 
initO; 


) 


private void init() { 

/ 创建 一 个 新 的 画笔 

mPaint = new Paint(); 

mPad = Utils.dip2px(mContext, 15); 

/ 从 资源 图 片 icon_point_n.png 中 得 到 背景 位 图 对 象 

mBackImage = BitmapFactory.decodeResource(getResources(), R.drawable.icon point_n); 

/ 从 资源 图 片 icon_point_c.png 中 得 到 前 景 位 图 对 象 

ImForeImage = BitmapFactory.decodeResource(getResources(), R.drawable.icon_point_c); 
' 


@Override 
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protected void dispatchDraw(Canvas canvas) { 


上 


Super.dispatchDraw(canvas); 
int left = (getMeasured Width() - mCount * mPad)/ 2; 
/ 先 绘制 作为 背景 的 几 个 灰色 圆 点 
for (inti= 0;i<mCount; H+) { 
canvas.drawBitmap(mBackImage, left +i* mPad, 0, mPaint); 
} 
/ 再 绘制 作为 前 景 的 高 亮 红 点 ， 该 红 点 随 着 翻 页 滑动 而 左右 滚动 
canvas.drawBitmap(mForeImage, left + (mSeq + mRatio) * mPad, 0, mPaint); 


// 设置 指示 器 的 个 数 ， 以 及 指示 器 之 间 的 距离 
public void setCount(int count, int pad) { 


b 


mCount = count; 
mPad = Utils.dip2px(mContext, pad); 
invalidate(); / 立刻 刷新 视图 


// 设置 指示 器 当前 移动 到 的 位 置 ， 及 其 位 移 比率 
public void setCurrent(int seq, float ratio) { 


} 


mSeq = seq; 
mRatio = ratio; 
invalidate0; / 立刻 刷新 视图 


有 了 自 定义 的 指示 器 控件 , 就 可 以 重 写 OnPageChangeListener 接口 的 onPageScrolled 方法 
了 。 在 该 方法 中 调用 指示 器 的 setCurrent 方法 就 能 动态 刷新 高 亮 圆 点 的 滚动 动画 ， 滚 动 效果 见 
图 7-24。 具 体 的 调用 代码 举例 如 下 : 
/ 定义 一 个 广告 轮 播 监听 器 
private class BannerChangeListener implements ViewPagerOnPageChangeListener { 


/ 翻 页 状态 改变 时 触发 
public void onPageScrollStateChanged(int arg0) {} 


/ 在 翻 页 过 程 中 触发 

public void onPageScrolled(int seq, float ratio, int offset) { 
// 设置 指示 器 高 亮 圆 点 的 位 置 
pi_bannersetCurrent(seq, ratio); 

} 


/ 在 翻 页 结束 后 触发 
public void onPageSelected(int seq) { 
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/ 设置 指示 器 高 亮 圆 点 的 位 置 
Pi_banner.setCurrent(seq, 0); 


上 
7.3.2 ”实现 横幅 轮 播 Banner 


前 面 给 ViewPager 加 了 指示 器 , 不 过 仍然 是 静止 页 面 , 只 有 用 户 在 屏幕 上 左右 滑动 时 才 会 
进行 翻 页 动作 。 看 看 电 商 App 的 首页 ， 显 眼 位 置 的 Banner 会 自动 滚动 ， 每 隔 两 三 秒 就 轮 播 下 
-个 广告 页 ， 让 页 面 烟 烟 生 辉 。 不 过 这 难 不 倒 我 们 ， 自 动 滚动 不 就 是 加 一 个 动画 效果 么 ? 第 6 
章 的 自 定 义 动 画 知识 正好 派 上 用 场 。 只 要 结合 Handlert+Runnable, 实现 一 个 简单 动画 非常 容易 。 
下 面 是 自 定义 Banner 的 代码 ， 相 当 于 启动 引导 页 的 代码 加 上 Handler 与 Runnable 组 合 : 


public class BannerPager extends RelativeLayout implements View.OnClickListener { 
private Context mContext; / 声明 一 个 上 下 文 对 象 
private ViewPager vp_banner // 声明 一 个 翻 页 视图 对 象 
Private RadioGroup rg_indicator; / 声明 一 个 单 选 组 对 象 
Private List<ImageView> mViewList = new ArrayList<ImageView>(); / 声明 一 个 图 像 视图 队列 
private int mInterval = 2000; / 轮 播 的 时 间 间 隔 ， 单 位 毫秒 


public BannerPager(Context context) { 
this(context, null); 


: 


public BannerPager(Context context, AttributeSet attrs) { 


super(context, attrs); 
mContext = context; 
initView(); 

) 

/ 开始 广告 轮 播 


public void start() { 
/ 延迟 若干 秒 后 启动 滚动 任务 
mHandler.postDelayed(mScroll, mInterval); 
} 


/ 停止 广告 轮 播 
public void stopO { 
/ 移 除 滚动 任务 
mHandlerremoveCallbacks(mScroll); 
} 


// 设置 广告 图 片 队列 
public void setImage(ArrayList<Integer> imageList) { 
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int dip_15 = Utils.dip2px(mContext, 15); 

/ 根据 图 片 队列 生成 图 像 视图 队列 

for (inti= 0; i < imageList.size(); i++) { 
Integer imageID = imageList.get(i); 
ImageView iv = new ImageView(mContext); 
iv.setLayoutParams(new LayoutParams( 

LayoutParams.MATCH PARENT, LayoutParams.MATCH PARENT)); 
iv.setScaleType(ImageView.ScaleType.FIT_XY); 
iv.setImageResource(imageID); 
iv.setOnClickListener(this); 
mViewList.add(iv); 

} 
/ 设置 翻 页 视图 的 图 像 翻 页 适配器 
vp_banner.setAdapter(new ImageAdapater()); 
/ 给 翻 页 视图 添加 简单 的 页 面 变更 监听 器 ， 此 时 只 需 重 写 onPageSelected 方法 
vp_banner.addOnPageChangeListener(new SimpleOnPageChangeListener() { 
@Overide 
public void onPageSelected(int position) { 
/ 高 亮 显示 该 位 置 的 指示 按钮 
setButton(position); 
} 
»); 
/ 根据 图 片 队列 生成 指示 按钮 队列 
for (int i= 0; i < imageList.size(); i++) { 
RadioButton radio = new RadioButton(mContext); 
radio.setLayoutParams(new RadioGroup.LayoutParams(dip_15, dip_15)); 
radio.setGravity(Gravity.CENTER):; 
radio.setButtonDrawable(R.drawable.indicator_selector); 
rg_indicator.addView(radio); 
} 
/ 设置 翻 页 视图 默认 显示 第 一 页 
vp_banner.setCurrentltem(0); 
/ 默认 高 亮 显示 第 一 个 指示 按钮 
setButton(0); 


/ 设置 选中 单 选 组 内 部 的 哪个 单 选 按钮 
Private void setButton(int position) { 


/ 初始 化 


((RadioButton) rg_indicator.getChildAt(position)).setChecked(true); 





private void initView() { 
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/ 根据 布局 文件 banner pagerxml 生成 视图 对 象 

View view = Layoutmflater from(mContext).inflate(R.layoutbanner pager null); 
/ 从 布局 文件 中 获取 名 叫 vp_banner 的 翻 页 视图 

vp_banner = view.findViewById(R.id.vp_banner); 

1/ 从 布局 文件 中 获取 名 叫 rg_indicator 的 单 选 组 

rg_indicator = view.findViewById(R.id.rg_indicaton); 

addView(view); / 将 该 布局 视图 添加 到 横幅 轮 播 条 


private Handler mHandler = new Handler(); / 声明 一 个 处 理 器 对 象 
// 定义 一 个 滚动 任务 
private Runnable mScroll = new Runnable() { 
(QOverride 
public void run0O) { 
scrollToNext0; / 滚动 广告 图 片 
/ 延迟 若干 秒 后 继续 启动 滚动 任务 
mHandler.postDelayed(this, mInterval); 


}; 


// 滚动 到 下 一 张 广 告 图 
public void scrollToNextO { 
/ 获得 下 一 张 广 告 图 的 位 置 
int index = vp_banner.getCurrentItem() + 1; 
if (index >= mViewList.sizeO) { 
index = 0; 
} 
/ 设置 翻 页 视图 显示 指定 位 置 的 页 面 
vp_banner.setCurrentItem(index); 


由 


/ 定义 一 个 图 像 翻 页 适配器 
private class ImageAdapater extends PagerAdapter { 


/ 获取 页 面 项 的 个 数 
public int getCountO { 

return mViewList.size(); 
上 


@Override 

public boolean isViewFromObject(View arg0, Object arg1) { 
Teturn arg0 一 argl; 

} 
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/ 从 容器 中 销毁 指定 位 置 的 页 面 
public void destroyItem(ViewGroup container int position, Object object) { 
containerremoveView(mViewList.get(position)); 


} 


/ 实例 化 指定 位 置 的 页 面 ， 并 将 其 添加 到 容器 中 

public Object instantiateItem(ViewGroup container, int position) { 
container.addView(mViewList.get(position)); 
return mViewList.get(position); 


b 


@Override 

public void onClick(View v) { 
/ 获取 翻 页 视图 当前 页 面 项 的 序号 
int position = vp_banner.getCurrentItem(); 
/ 触发 点 击 监听 器 的 onBannerClick 方法 
mListener.onBannerClick(position); 


} 


/ 设置 广告 图 的 点 击 监听 器 
public void setOnBannerListener(BannerClickListener listener) { 
mListener = listener; 


b 


// 声明 一 个 广告 图 点 击 的 监听 器 对 象 
private BannerClickListener mListener; 
/ 定义 一 个 广告 图 片 的 点 击 监听 器 接口 
public interface BannerClickListener { 
void onBannerClick(int position); 
} 


在 Activity 代码 中 使 用 这 个 自 定义 的 Banner 控件 不 难 ， 主 要 是 先 调 用 setImage 方法 设置 
图 片 列表 ， 再 调用 start 方法 启动 轮 播 动画 ， 具 体 代码 如 下 : 
/ 从 布局 文件 中 获取 名 叫 banner_pager 的 横幅 轮 播 条 
BannerPager banner = findViewById(R.id.banner pager); 
/ 获取 横幅 轮 播 条 的 布局 参数 


LayoutParams params = (LayoutParams) banner.getLayoutParams(); 
params.height = (int) (Utils.getScreenWidth(this) * 250f / 640f); 
/ 设置 横幅 轮 播 条 的 布局 参数 


banner.setLayoutParams(params); 
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/ 设置 横幅 轮 播 条 的 广告 图 片 队列 
banner.setImage(ImageList.getDefaultO); 
/ 开始 广告 图 片 的 轮 播 滚动 
banner.start(); 


然后 观察 Banner 轮 播 的 动画 效果 ， 此 时 轮 播 到 第 4 张 图 片 ， 如 图 7-25 所 示 。 轮 播 到 第 5 
张 图 片 的 效果 如 图 7-26 所 示 。 





招牌 惠 搬 新 家 啦 


小 积分 淘 优 惠 天 天 有 好 礼 





。. 
图 7-25 轮 播 到 第 4 张 图 片 图 7-26 轮 播 到 第 5 张 图 片 
7.3.3“” 仿 京东 项 到 状态 栏 的 Banner 


上 一 小 节 介 绍 了 如 何 实现 广告 轮 播 的 Banner 效果 ， 本 想 可 以 告 一 段落 。 然 而 某 天 产品 经 
理 心 血 来 潮 ， 拿 着 苹果 手机 ， 要 求 像 iOS 那样 把 广告 图 项 到 状态 栏 这 儿 。 刚 接 到 这 需求 ， 不 
禁 倒 吸 一 口 冷 气 ， 又 要 安 卓 开发 去 实现 iOS 的 效果 ， 真 是 强人 所 难 。 翻 了 翻 资料 ， 发 现 修改 
状态 栏 的 颜色 倒是 可 行 ， 但 要 把 轮 播 图 项 上 去 就 不 容易 了 。 再 隔 隔 淘宝 和 当当 ,原来 两 个 大 厂 
的 App 都 没 做 出 这 个 效果 。 正 想 跟 产品 经 理 说 这 个 实现 不 了 ， 谁 料 产品 大 姐 笑 鼻 怖 地 走 过 来 ， 
指 着 手机 说 道 : “你 看 ， 做 成 京东 这 样 就 行 了 。” 上 杂 着 手机 看 了 半 上 ， 京 东 这 肠 还 真 的 让 轮 播 
图 插 进 状态 栏 了 ， 于 是 瞬间 石化 。 且 看 京东 App 的 首页 头 部 如 图 7-27 所 示 。 








图 7-27 京东 App 的 首页 头 部 效果 


每 当 此 时 ， 便 是 程序 员 最 煎熬 的 时 候 ， 人 家 都 做 得 ， 为 喻 你 做 不 得 ? 只 好 继续 寻 寻 疯 疯 ， 
又 找到 另 一 个 电 商 App, 它 在 Android 6.0 手 机 上 也 完美 实现 了 状态 栏 悬 浮 效果 ,但 是 在 Android 
4.4 手机 运行 时 仍然 没 能 覆盖 状态 栏 。 可 见 这 真 不 是 一 个 省 油 的 灯 , 许多 人 用 的 App 尚且 未 能 
解决 悬浮 状态 栏 的 兼容 性 问题 。 该 电 商 App 的 首页 头 部 如 图 7-28 和 图 7-29 所 示 , 其 中 图 7-28 
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为 Android 6.0 手机 上 的 运行 界面 , 此 时 状态 栏 浮 在 轮 播 图 上 面 ; 图 7-29 为 Android 4.4 手机 的 
运行 界面 ， 此 时 状态 栏 依旧 与 轮 播 图 泾 渭 分 明 。 


100 信 








图 7-28 某 App 在 6.0 上 的 效果 图 7-29 某 App 在 44 上 的 效果 


早期 的 Android 版 本 姑且 不 提 ，Android 人 迟 至 4.4 才 开 始 支持 沉浸 式 状 态 栏 ， 编 码 的 时 候 
通过 Window 对 象 的 setAttributes 方法 来 设置 窗口 属性 的 标志 位 。 其 中 标志 位 
WindowManager.LayoutParams.FLAG_TRANSLUCENT STATUS 用 于 控制 项 部 状态 栏 是 
明 , 标 志 位 WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION 用 于 控制 底 
部 导航 栏 是否 透 明 。 具 体 的 实现 代码 如 下 所 示 : 

// Android 4.4 的 沉浸 式 状态 栏 写法 
Window window = activity.getWindow(); 





WindowManager.LayoutParams attributes = window.getAttributes(); 

int flagTranslucentStatus = WindowManager.LayoutParams.FLAG_ TRANSLUCENT _ STATUS; 

// 底部 导航 栏 也 可 以 弄 成 透明 的 

//int flagTranslucentNavigation = WindowManager.LayoutParams.FLAG_ TRANSLUCENT NAVIGATION; 
attributes.flags |= flag TranslucentStatus; 

//attributes.flags |= flagTranslucentNavigation; 

window.setAttributes(attributes); 


到 了 Android 5.0 之 后 版 本 ， 系 统 允 许 直 接 定制 状态 栏 的 颜色 ， 例 如 调用 Window 对 象 的 
setStatusBarColor 方法 即 可 设置 顶部 状态 栏 的 背景 色 ， 调 用 Window 对 象 的 
setNavigationBarColor 方 法 即 可 设置 底部 导航 栏 的 背景 色 。 不 过 状态 栏 的 悬浮 开关 发 生 了 变化 ， 
要 想 让 状态 栏 变 透明 ， 最 新 的 方式 是 调用 DecorView 对 象 的 setSystemUiVisibility 方法 来 设置 
标志 位 。 详 细 的 标志 位 设置 代码 如 下 所 示 : 


/Android 5.0 之 后 的 沉浸 式 状 态 栏 写法 
Window window = activity.getWindow(); 
View decorView = window.getDecorView(); 
/ 两 个 标志 位 要 结合 使 用 ， 表 示 让 应 用 的 主体 内 容 占 用 系统 状态 栏 的 空间 
/ 第 三 个 标志 位 可 让 底部 导航 栏 变 透明 View.SYSTEM_UI FLAG LAYOUT _ HIDE NAVIGATION 
int option = View.SYSTEM_UI FLAG LAYOUT FULLSCREEN 

| View.SYSTEM_ UI FLAG LAYOUT STABLE:; 
window.clearFlags(WindowManager.LayoutParams.FLAG TRANSLUCENT STATUS); 
decorView.setSystemUiVisibility(option); 
window.addFlags(WindowManager.LayoutParams.FLAG DRAWS SYSTEM BAR BACKGROUNDS); 
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然而 以 上 的 处 理 过程 只 解决 了 事情 的 一 个 方面 ， 即 成 功 将 状态 栏 悬浮 在 主页 面 之 上 ， 或 
者 说 将 主页 面 沉没 到 状态 栏 之 下 .可 是 事情 的 另 一 方面 一 一 把 悬浮 着 的 状态 栏 恢 复原 状 一 一 并 
没有 得 到 解决 ， 甚 至 给 状态 栏 换个 背景 色 都 不 行 。 辟 如 说 乘 船 过 河 ，Android 时 常 派 了 渡船 运 
送 乘 客 ， 可 是 当 你 到 达 彼岸 之 后 ， 却 发 现 回程 的 船上 只 不 见 了 踪影 。 就 恢复 状态 栏 的 原状 而 言 ， 
设置 标志 位 是 行 不 通 的 ， 幸 好 过 河 不 一 定 靠 船 , 还 有 一 招 叫做 瞒天过海 。 虽然 主页 面 已 经 和 状 
态 栏 重 辣 在 了 一 起 , 没 法 强行 把 它 俩 拆散 ,但 我 们 可 以 叫 主页 面 让 一 让 , 不 要 跟 状 态 栏 挨 得 这 
么 紧 ， 就 是 给 主页 面 设置 一 段 顶端 空白 ttppMargin， 表 示 主 权 在 我 、 不 妨 让 你 三 尺 ， 于 是 主页 
面 让 出 一 段 空白 , 看 起 来 就 与 状态 栏 井 水 不 犯 河水 了 。 如 此 一 来 ,状态 栏 的 悬浮 和 恢复 操作 便 
是 可 逆 的 了 ， 如 果 移 除 主页 面 的 顶端 室 白 ， 状 态 栏 就 产生 悬浮 效果 ; 如 果 添 加 主页 面 的 顶端 空 

对 于 Android 4.4， 情 况 还 会 更 加 特殊 ， 因 为 系统 没有 提供 设置 状态 栏 颜色 的 方法 ， 所 以 
只 能 手工 搞 个 假冒 的 状态 栏 来 占 坑 。 先 将 这 个 冒牌 状态 栏 (其 内 部 没有 别 的 控件 ) 染 上 开发 者 
指定 的 颜色 ,然后 与 系统 自 带 的 状态 栏 重合 ,于 是 乎 偷梁换柱 仿佛 给 状态 栏 换 了 一 件 衣裳。 修 
改 之 后 的 状态 栏 背景 设置 代码 如 下 所 示 兼容 Android 4.4， 以 及 5.0 以 上 版 本 这 两 种 情况 ) : 

// 重 置 状态 栏 。 即 把 状态 栏 颜色 恢复 为 系统 默认 的 黑色 
public static void reset(Activity activity) { 
setStatusBarColor(activity, Color. BLACK); 








, 


// 设置 状态 栏 的 背景 色 。 对 于 Android 4.4 和 Android 5.0 以 上 版 本 要 区 分 处 理 
public static void setStatusBarColor(Activity activity, int color) { 
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) { 
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { 
activity.getWindow().setStatusBarColor(color); 
// 底部 导航 栏 颜色 也 可 以 由 系统 设置 
/lactivity.getWindow().setNavigationBarColor(color); 
} else { 
setKitKatStatusBarColor(activity, color); 
} 
if(color 一 Color.TRANSPARENT) { // 透明 背景 表示 要 悬浮 状态 栏 
removeMarginTop(activity); 
}else { // 其 他 背景 表示 要 恢复 状态 栏 
addMarginTop(activity); 
} 


/ 


private static final String TAG FAKE STATUS BAR VIEW = "statusBarView"; 
private static final String TAG MARGIN ADDED = "marginAdded"; 

// 添加 顶部 间隔 ， 留 出 状态 栏 的 位 置 

Private static void addMarginTop(Activity activity) { 
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Window window = activity.getWindow(); 
ViewGroup contentView = window.findViewById(Window.ID ANDROID_ CONTENT); 
View child = contentView.getChildAt(0); 
让 (ITAG_ MARGIN ADDED.equals(child.getTag()) { 
FrameLayout.LayoutParams params = (FrameLayout.LayoutParams) child.getLayoutParams(); 
/ 添加 的 间隔 大 小 就 是 状态 栏 的 高 度 
params.topMargin += getStatusBarHeight(activity); 
child.setLayoutParams(params); 
child.setTag(TAG MARGIN_ADDED); 


// 移 除 顶 部 间隔 ， 霸 占 状 态 栏 的 位 置 
private static void removeMarginTop(Activity activity) { 
Window window = activity.getWindow(); 
ViewGroup contentView = window.findViewById(Window.ID_ ANDROID_ CONTENTJ); 
View child = contentView.getChildAt(0); 
if (TAG MARGIN ADDED.equals(child.getTag())) { 
FrameLayout.LayoutParams params = (FrameLayout.LayoutParams) child.getLayoutParams(); 
// 移 除 的 间隔 大 小 就 是 状态 栏 的 高 度 
params.topMargin -= getStatusBarHeight(activity); 
child.setLayoutParams(params); 
child.setTag(null); 


// 对 于 Android 4.4， 系 统 没有 提供 设置 状态 栏 颜色 的 方法 ， 只 能 手工 搞 个 假冒 的 状态 栏 来 占 坑 
private static void setKitKatStatusBarColor(Activity activity, int statusBarColor) { 
Window window = activity.getWindow(); 
ViewGroup decorView = (ViewGroup) window.getDecorView(); 
// 先 移 除 已 有 的 冒牌 状态 栏 
View fakeView = decorView.findViewWithTag(TAG FAKE STATUS _ BAR VIEW); 
if (fakeView != nulD) { 
decorView.removeView(fakeView); // 从 根 视图 移 除 旧 状 态 栏 
} 
/ 再 添加 新 来 的 冒牌 状态 栏 
View statusBarView = new View(activity); 
FrameLayout.LayoutParams params = new FrameLayout.LayoutParams( 
ViewGroup.LayoutParams.MATCH PARENT, getStatusBarHeight(activity)); 
params.gravity = Gravity.TOP:; 
statusBarView.setLayoutParams(params); 
statusBarView.setBackgroundColor(statusBarColor); 
statusBarView.setTag(TAG FAKE STATUS BAR VIEW); 
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decorView.addView(statusBarView); / 往 根 视图 添加 新 状态 栏 
} 

总 算 大 功 告 成 ， 接 着 看 看 实际 的 运行 效果 ， 具 体 界面 如 图 7-30 和 图 7-31 所 示 。 由 于 上 述 
代码 同时 兼容 Android4.4， 以 及 5.0 以 上 版 本 这 两 种 情况 ， 因 此 就 不 重复 贴图 了 。 其 中 图 7-30 
为 悬浮 状态 栏 的 效果 图 ， 图 7-31 为 恢复 状态 栏 的 效果 图 。 

46 回 雹 中 


精彩 好 礼 等 你 来 让 招牌 惠 搬 新 家 啦 


; 小 积分 淘 优 惠 天 天 有 好 礼 
| 0 元 还 款 金 /399 积分 和 ] 





图 7-30 悬浮 状态 栏 的 效果 图 7-31 恢复 状态 栏 的 效果 
7.4 ”增强 型 列表 


本 节 介 绍 通过 循环 视图 RecyclerView 实现 各 种 增强 型 列表 ， 包 括 线性 列表 布局 、 普 通 网 
格 布局 、 瀑 布 流 网 格 布局 等 ， 并 对 循环 视图 进行 动态 更 新 操作 。 
7.4.1 循环 视图 RecyclerView 


如 果 说 TabLayout 是 导航 栏 一 节 的 压轴 兵器 ， 那 么 循环 视图 RecyclerView 就 是 本 章 的 终 
极 兵器 , 因为 功能 实在 是 太 强大 了 , 强大 到 秒杀 列表 视图 ListView, 再 秒杀 网 格 视 图 GridView， 
还 能 秒杀 瀑布 流 网 格 开源 框架 StaggeredGridView 和 PinterestLikeAdapterView， 总 之 学 会 了 
RecyclerView， 你 的 App 武功 必然 提高 一 个 层次 。 

因为 RecyclerView 是 5.0 之 后 的 新 增 控件 ， 所 以 为 了 兼容 以 前 的 Adnroid 版 本 ,在 使 用 该 
控件 前 要 修改 build.gradle， 在 dependencies 节点 中 加 入 以 下 代码 表示 导入 recyclerview 库 : 


implementation 'com.android.support:recyclerview-v7:28.0.0' 
下 面 看 看 强悍 的 循环 视图 提供 的 常用 方法 。 


e@ setAdapter: 设置 列表 项 的 适配器 。 适 配器 采用 RecyclerView.Adapter。 

e setLayoutManager : 设置 列表 项 的 布局 管理 器 ， 包 括 线 性 布局 管理 器 
LinearLayoutManager、 网 格 布局 管理 器 GridLayoutManager、 瀑 布 流 网 格 布局 管理 器 
StaggeredGridLayoutManager。 

。 addItemDecoration: 添加 列表 项 的 分 割 线 。 

e@ removeltemDecoration: 移 除 列表 项 的 分 割 线 。 

e setItemAnimator: 设置 列表 项 的 增删 动画 。 默 认 动 画 为 系统 自 带 的 DefaultItemAnimator。 
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e@ addOnltemTouchListener: 添加 列表 项 的 触摸 监听 器 。 因 为 RecyclerView 没有 实现 列表 项 
的 点 击 接口 ， 所 以 开发 者 可 通过 这 里 的 触摸 监听 器 监控 用 户 手势 。 

e@ ”removeOnItemTouchListener: 移 除 列表 项 的 触摸 监听 器 。 

e@ ”scrollToPosition: 滚动 到 指定 位 置 。 


RecyclerView 有 专门 的 适配器 类 一 一 RecyclerView.Adapter。 在 调用 RecyclerView 的 setAdapter 
方法 前 ， 得 先 实现 一 个 从 RecyclerView.Adapter 派生 而 来 的 数据 适配器 ， 用 来 定义 列表 项 的 布 
局 与 具体 操作 。 下 面 是 与 RecyclerView.Adapter 相关 的 常用 方法 。 

1. 自 定义 适配器 必须 要 重 写 的 方法 。 


e@ ”getltemCount: 获得 列表 项 的 数目 。 

e@ onCreateViewHolder: 创建 整个 布局 的 视图 持 有 者 。 输 入 参数 中 包括 视图 类 型 ， 可 根据 视 
图 类 型 加 载 不 同 的 布局 ， 从 而 实现 带头 部 的 列表 布局 。 

e onBindViewHolder: 绑 定 每 项 的 视图 持 有 者 。 


2. 可 以 重 写 也 可 以 不 重 写 的 方法 。 


。 getltemViewType: 返回 每 项 的 视图 类 型 . 这 个 视图 类 型 供 onCreateViewHolder 方法 使 用 。 
e getltemId: 获得 每 项 的 编号 。 


3. 可 以 直接 调用 的 方法 。 


notifyItemInserted: 通知 适配器 在 指定 位 置 已 插入 新 项 。 
notifyltemRemoved: 通知 适配器 在 指定 位 置 已 删除 原 有 项 。 
notifyItemChanged: 通知 适配器 在 指定 位 置 的 项 目 已 发 生变 化 。 
notifyDataSetChanged: 通知 适配器 整个 列表 的 数据 已 发 生变 化 。 


下 面 是 RecyclerView.Adapter 一 个 派生 类 的 代码 : 


© 0 @ @ 


public class RecyclerLinearAdapter extends RecyclerView.Adapter<ViewHolder> implements 
OnltemClickListener, OnItemLongClickListener { 
private Context mContext; // 声明 一 个 上 下 文 对 象 
Private ArrayList<GoodsInfo> mPublicArray; 


public RecyclerLinearAdapter(Context context ArrayList<GoodsInfo> publicArray) { 
mContext = context; 
mPublicArray = publicArray; 

) 


/ 获取 列表 项 的 个 数 
public int getItemCountO { 
return mPublicArray.size(); 
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// 创建 列表 项 的 视图 持 有 者 

public ViewHolder onCreateViewHolder(ViewGroup vg, int view Type) { 
/ 根据 布局 文件 item_linearxml 生成 视图 对 象 
View v = LayoutInflater.from(mContext).inflate(R.layout.item linear, vg, false); 
return new ItemHolder(v); 


/ 绑 定 列表 项 的 视图 持 有 者 
public void onBindViewHolder(ViewHolder vh, final int position) { 
TtemHolder holder = (TtemHolder) vh; 
holder.iv_pic.setImageResource(mPublicArray.get(position).pic_id); 
holder.tv_title.setText(mPublicArray.get(position).title); 
holder.tv_desc.setText(mPublicArray.get(position).desc); 
/ 列表 项 的 点 击 事件 需要 自己 实现 
holder.ll item.setOnClickListener(new OnClickListener() { 
public void onClick(View v) { 
if (mOnItemClickListener != null) { 
mOnltemClickListener.onItemClick(v, position); 
} 
了 
); 
/ 列表 项 的 长 按 事件 需要 自己 实现 
holder.ll item.setOnLongClickListener(new OnLongClickListener() { 
public boolean onLongClick(View v) { 
if (mOnItemLongClickListener != null) { 
mOnltemLongClickListener.onItemLongClick(v, position); 
} 


return true; 
b 
/ 获取 列表 项 的 类 型 


public int getItemViewType(int position) { 
// 这 里 返回 每 项 的 类 型 ， 开 发 者 可 自 定义 头 部 类 型 与 一 般 类 型 ， 


// 然后 在 onCreateViewHolder 方法 中 根据 类 型 加 载 不 同 的 布局 ， 从 而 实现 带头 部 的 网 格 布局 


return 0; 


} 


/ 获取 列表 项 的 编号 
public long getItemId(int position) { 
return position; 


274 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


/ 定义 列表 项 的 视图 持 有 者 

public class ItemHolder extends RecyclerView.ViewHolder { 
public LinearLayout Litem; / 声明 列表 项 的 线性 布局 
public ImageView iv_pic; / 声明 列表 项 图 标的 图 像 视 图 
public TextView tv_title; / 声明 列表 项 标题 的 文本 视图 
public TextView tv_desc; / 声明 列表 项 描述 的 文本 视 





public ItemHolder(View v) { 
Super(V); 
ll item = v.findViewById(R.id.ll_item); 
iv_pic = v.findViewById(R.id.iv_pic); 
tv _title = v.findViewById(R.id.tv_title); 
tv_desc = v.findViewById(R.id.tv_desc); 


// 声明 列表 项 的 点 击 监听 器 对 象 

private OnItemClickListener mOnItemClickListener; 

public void setOnItemClickListener(OnltemClickListener listener) { 
this.mOnItemClickListener = listener; 


// 声明 列表 项 的 长 按 监听 器 对 象 

private OnItemLongClickListener mOnItemLongClickListener; 

public void setOnItemLongClickListener(OnltemLongClickListener listener) { 
this.mOnItemLongClickListener = listener; 


// 处 理 列表 项 的 点 击 事件 
public void onItemClick(View view, int position) { 
String desc = String.format(" 您 点 击 了 第 %d 项 ， 标 题 是 %s", position + 1， 
mpPublicArray.get(position).title); 
Toast.makeText(mContext, desc, Toast.LENGTH_SHORT).show(); 


// 处 理 列表 项 的 长 按 事件 
public void onItemLongClick(View view, int position) { 
String desc = String.format(" 您 长 按 了 第 %d 项 ， 标 题 是 %s", position + 1， 
mPublicArray.get(position).title); 
Toast.makeText(mContext, desc, Toast. LENGTH_SHORT).show(); 
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下 面 是 在 活动 页 面 中 操作 循环 视图 及 其 适配器 的 代码 片段 : 


/ 初始 化 线性 布局 的 循环 视图 
Private void initRecyclerLinear() { 
// 从 布局 文件 中 获取 名 叫 rv_linear 的 循环 视图 
RecyclerView rv_linear = findViewById(R.id.rv_linear); 
/ 创建 一 个 垂直 方向 的 线性 布局 管理 器 
LinearLayoutManager manager = new LinearLayoutManager(this, LinearLayouLVERTICAL, false); 
/ 设置 循环 视图 的 布局 管理 器 
IV_linear.setLayout Manager(manager); 
// 构建 一 个 公众 号 列表 的 线性 适配器 
RecyclerLinearAdapter adapter = new RecyclerLinearAdapter(this, GoodsInfo.getDefaultList()); 
/ 设置 线性 列表 的 点 击 监 听 器 
adaptersetOnItemClickListener(adapter); 
/ 设置 线性 列表 的 长 按 监听 器 
adapter.setOnItemLongClickListener(adapter); 
// 给 rv_linear 设置 公众 号 线性 适配器 
TV_linear.setAdapter(adapter); 
/ 设置 rv_linear 的 默认 动画 效果 
TV_linear.setItemAnimator(new DefaultItemAnimator()); 
/ 给 rv_linear 添加 列表 项 之 间 的 空白 装饰 
rV_linear.addItemDecoration(new SpacesItemDecoration(1)); 
} 


上 面 的 代码 实现 的 循环 视图 效果 如 图 7-32 所 示 。 这 里 仿照 微 信 公众 号 的 消息 列表 ， 看 起 
来 像 是 用 ListView 实现 的 ， 当 然 RecyclerView 的 实际 功能 并 不 仅 限 于 此 。 
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图 7-32 循环 视图 的 简单 实现 
7.4.2 布局 管理 器 LayoutManager 





布局 管理 器 LayoutManager 是 RecyclerView 的 精髓 ， 也 是 RecyclerView 强悍 的 源泉 。 
LayoutManager 不 但 提供 了 3 类 布局 管理 ， 分 别 实现 类 似 列表 视图 、 网 格 视图 、 瀑 布 流 网 格 的 
效果 , 而 且 可 在 代码 中 随时 由 循环 视图 对 象 调用 setLayoutManager 方法 设置 新 的 布局 。 一 旦 调 
用 了 setLayoutManager 方法 , 界面 就 会 根据 新 布局 刷新 列表 项 。 这 个 特性 特别 适用 于 手机 在 竖 
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屏 与 横 屏 之 间 的 显示 切换 (如 竖 屏 时 展示 列表 , 横 屏 时 展示 网 格 )， 也 适用 于 在 不 同 屏幕 分 辨 
率 (如 手机 与 平板 ) 之 间 的 显示 切换 〈 如 在 手机 上 展示 列表 ， 在 平板 上 展示 网 格 ) 。 下 面 对 这 
3 类 布局 管理 器 分 别 进 行 介绍 。 


1. 线性 布局 管理 器 LinearLayoutManager 


LinearLayoutManager 类 似 于 线性 布局 LinearLayout, 在 垂 直方 向 布局 时 ， 展 示 效 果 类 似 于 
垂直 的 列表 视图 ListView; 在 水 平方 向 布局 时 ， 展 示 效 果 类 似 于 水 平 的 列表 视图 。 
下 面 是 LinearLayoutManager 的 常用 方法 。 


e@ 构造 函数 : 可 指定 列表 的 方向 和 是 否 为 相反 方向 开始 布局 。 

e@ setOrientation :设置 列表 的 方向 ， 可 取 值 LinearLayout.HORIZONTAL 或 LinearLayout. 
VERTICAL。 

@ setReverseLayout :设置 是 否 为 相反 方向 开始 布局 ， 默 认 人 lse。 如 果 设 置 为 tue， 那 么 垂 
直方 向 将 从 下 往 上 开始 布局 ， 水 平方 向 将 从 右 往 左 开始 布局 。 


前 面 在 介绍 循环 视图 时 采用 的 代码 基于 线性 布局 管理 器 ， 具 体 的 效果 如 图 7-27 所 示 。 对 
于 令 人 头疼 的 列表 项 分 隔 线 , RecyclerView 采取 的 做 法 是 让 开发 者 自 定义 分 阳线 的 样式 。 下 面 
是 一 个 最 简单 的 分 阳线 的 实现 ， 允 许 设置 分 隔 线 的 宽度 ， 代 码 如 下 : 
public class SpacesItemDecoration extends RecyclerView.ItemDecoration { 
private int space; // 空白 间隔 
public SpacesItemDecoration(int space) { 





this.space = space; 
由 


public void getItemOffsets(Rect outRect View view, RecyclerView parent, RecyclerView.State state) { 
outRect.left= space; // 左边 空白 间隔 
outRect.right = space; ”// 右边 空白 间隔 
outRect.bottom = space; // 上 方 空白 间隔 
outRecttop = space; // 下 方 空白 间隔 


} 
2. 网 格 布局 管理 器 GridLayoutManager 


GridLayoutManager 类 似 于 网 格 布局 GridLayout (该 控件 是 Android 4.0 之 后 新 加 的 ) 。 从 
展示 效果 来 看 ,GridLayoutManager 类 似 于 网 格 视图 GridView。 所 以 ,我 们 不 用 关心 GridLayout， 
把 GridLayoutManager 当成 GridView 一 样 使 用 就 好 了 。 

下 面 是 GridLayoutManager 的 常用 方法 。 

。 构造 函数 : 可 指定 网 格 的 列 数 。 

e@ setSpanCount: 设置 网 格 的 列 数 。 

esetSpanSizeLookup: 设置 列表 项 的 占 位 规则 。 默 认 一 项 点 一列， 如果 想 某 项 占 多 列 ， 就 
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可 以 在 此 设置 占 位 规则 ， 即 由 GridLayoutManager.SpanSizeLookup 派生 具体 的 实现 类 。 
下 面 是 在 活动 页 面 中 操作 网 格 布局 管理 器 的 示例 代码 : 
// 初始 化 网 格 布局 的 循环 视图 
private void initRecyclerGrid() { 
/ 从 布局 文件 中 获取 名 叫 rv_grid 的 循环 视图 
RecyclerView rv_grid = findViewById(R.id.rv_grid); 
/ 创建 一 个 垂直 方向 的 网 格 布局 管理 器 
GridLayoutManager manager = new GridLayoutManager(this, 5); 
/ 设置 循环 视图 的 布局 管理 器 
ry_grid.setLayout Manager(manager); 
/ 构建 一 个 市 场 列表 的 网 格 适配器 
RecyclerGridA dapter adapter = new RecyclerGridA dapter(this, GoodsInfo.getDefaultGrid()); 
// 给 rv_grid 设置 市 场 网 格 适配器 
ry_grid.setAdapter(adapter); 
| 


网 格 布局 管理 器 的 效果 如 图 7-33 所 示 ， 看 起 来 跟 GridView 的 展示 效果 没什么 区 别 。 





7-33 ”循环 视图 的 网 格 布局 


但 绝 非 GridView 可 比 , 因为 网 格 布局 管理 器 提供 了 setSpanSizeLookup 方法 , 该 方法 允许 
-个 网 格 占据 多 列 空间 ， 更 加 灵活 易 用 。 下 面 是 使 用 占 位 规则 的 网 格 管理 器 代码 片段 : 


/ 初始 化 合并 网 格 布局 的 循环 视图 
private void initRecyclerCombineO { 
/ 从 布局 文件 中 获取 名 叫 rv_combine 的 循环 视图 
RecyclerView rv_combine = findViewById(R.id.rv_combine); 
/ 创建 一 个 四 列 的 网 格 布局 管理 器 
GridLayoutManager manager = new GridLayoutManager(this, 4); 
/ 设置 网 格 布局 管理 器 的 占 位 规则 
/ 以 下 占 位 规则 的 意思 是 : 第 一 项 和 第 二 项 占 两 列 ， 其 他 项 占 一 列 ; 
/ 如 果 网 格 的 列 数 为 四 ， 那 么 第 一 项 和 第 二 项 平分 第 一 行 ， 第 二 行 开始 每 行 有 四 项 。 
manager.setSpanSizeLookup(new GridLayout Manager.SpanSizeLookup() { 
public int getSpanSize(int position) { 
让 (position 一 01|position 一 1) {// 为 第 一 项 或 者 第 二 项 
retum 2; // 占据 两 列 
} else {// 为 其 他 项 
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retum 1;// 占据 一 列 


} 
D; 
/ 设置 循环 视图 的 布局 管理 器 
ry_combine.setLayout Manager(manager); 
/ 构建 一 个 猜 你 喜欢 的 网 格 适配器 
RecyclerCombineAdapter adapter = new RecyclerCombineAdapter( 
this, GoodsInfo.getDefaultCombine()); 
/ 给 rv_combine 设置 猜 你 喜欢 网 格 适 配器 
TV_combine.setAdapter(adapter); 
| 


使 用 占 位 规则 的 效果 如 图 7-34 所 示 。 可 以 看 到 ， 第 一 行 只 有 两 个 网 格 ， 第 二 行 有 4 个 网 
格 ， 这 意味 着 第 一 行 的 每 个 网 格 都 占据 了 两 列 位 置 。 





买 哪个 别 想 了 


7-34 ”循环 视图 的 合并 网 格 布局 效果 


3. 瀑布 流 网 格 布局 管理 器 StaggeredGridLayoutManager 


电 商 App 在 展示 众多 商品 信息 时 ， 往 往 使 用 灵活 高 效 的 格子 展示 。 因 为 不 同 商品 的 外 观 
尺寸 不 一 样 ， 比 如 冰箱 高 的 纵向 比较 长 ， 空 调 横 向 比较 长 ， 所 以 若 用 一 样 规格 的 网 格 展示 ， 必 
然 有 的 商品 图 片 会 被 压缩 得 很 小 。 这 种 情况 得 根据 不 同 的 商品 形状 展示 不 同 高 度 的 图 片 , 这 就 
是 瀑布 流 网 格 的 应 用 场合 。StaggeredGridLayoutManager 让 瀑布 流 效 果 的 开发 大 大 简化 了 ， 只 
要 在 适配器 中 动态 设置 每 个 网 格 的 高 度 ， 系 统 就 会 自动 在 界面 上 依次 排列 瀑布 流 网 格 。 

下 面 是 StaggeredGridLayoutManager 的 常用 方法 。 


构造 函数 : 可 指定 网 格 的 列 数 和 方向 。 

setSpanCount: 设置 网 格 的 列 数 。 

setOrientation: 设置 瀑布 流 布 局 的 方向 。 取 值 说 明 同 LinearLayoutManager。 
setReverseLayout: 设置 是 否 为 相反 方向 开始 布局 ， 默 认 但 lse。 如 果 设 置 为 rue， 那 么 垂 
直方 向 将 从 下 往 上 开始 布局 ， 水 平方 向 将 从 右 往 左 开始 布局 。 


下 面 是 在 活动 页 面 中 操作 瀑布 流 网 格 布局 管理 器 的 示例 代码 : 
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// 初始 化 瀑布 流 布局 的 循环 视图 

private void initRecyclerStaggeredO { 
// 从 布局 文件 中 获取 名 叫 rv_staggered 的 循环 视图 
RecyclerView rv_staggered = findViewById(R.id.rv_staggered); 
// 创建 一 个 垂直 方向 的 瀑布 流 布局 管理 器 
StaggeredGridLayoutManager manager = new StaggeredGridLayoutManager( 

3, LinearLayouLVERTICAL); 

/ 设置 循环 视图 的 布局 管理 器 
TV_staggered.setLayoutManager(manager); 
/ 构建 一 个 服装 列表 的 瀑布 流 适配器 
RecyclerStaggeredAdapter adapter = new RecyclerStaggeredA dapter(this, GoodsInfo.getDefaultStag()); 
/ 设置 瀑布 流 列表 的 点 击 监听 器 
adapter.setOnltemClickListener(adapter); 
/ 设置 瀑布 流 列 表 的 长 按 监听 器 
adapter.setOnIltemLongClickListener(adapter); 
1/ 给 rv_staggered 设置 服装 瀑布 流 适配器 
TV_staggered.setAdapter(adapter); 
// 设置 rv_staggered 的 默认 动画 效果 
TV_staggered.setItemAnimator(new DefaultItemAnimator()); 
/ 给 rv_staggered 添加 列表 项 之 间 的 空白 装饰 
TV_staggered.addItemDecoration(new SpacesItemDecoration(3)); 


有 

瀑布 流 网 格 布 局 的 效果 如 图 7-35 与 图 7-36 所 示 , 每 个 网 格 的 高 度 依照 具体 图 片 的 高 度 变 
化 而 变化 ， 整 个 页 面 看 起 来 变 得 生动 活泼 。 读 者 可 以 打开 淘宝 App, 在 项 部 导航 栏 搜索 “ 连 衣 
衬 ”， 看 看 搜索 结果 页 面 是 不 是 如 瀑布 流 网 格 这 般 交 错 显示 。 
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图 7-35 循环 视图 的 瀑布 流 效果 1 图 7-36 循环 视图 的 瀑布 流 效果 2 
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7.4.3 动态 更 新 循环 视图 


循环 视图 之 所 以 成 为 终极 兵器 ， 不 单单 因为 具备 列表 视图 、 网 格 视图 、 瀑 布 流 网 格 三 者 
的 功力 ， 更 是 因为 允许 动态 更 新 内 部 数据 。 不 但 可 以 单独 更 新 某 项 视图 ,而且 能 够 顺便 展示 增 
删 动画 ， 好 比 刀 光 剑 影 起 落 之 际 还 在 演奏 乐曲 ， 这 才 是 真正 的 无 招 有 性 有 招 。 

下 面 是 在 Acitivity 页 面 中 对 循环 视图 内 部 数据 进行 动态 增 、 删 、 改 的 代码 片段 : 


public class RecyclerDynamicActivity extends AppCompatActivity implements OnClickListener 
, OnItemClickListener, OnltemLongClickListener, OnItemDeleteClickListener { 
private RecyclerView rv_dynamic; / 声明 一 个 循环 视图 对 象 
private LinearDynamicAdapter mAdapter; // 声明 一 个 线性 适配器 对 象 
private ArrayList<GoodsInfo> mPublicArray; // 当前 公众 号 信息 队列 
private ArrayList<GoodsInfo> mAllArray; // 所 有 公众 号 信息 队列 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_recycler_dynamic); 
findViewById(R.id.btn_recycler add).setOnClickListener(this); 
initRecyclerDynamic(); / 初始 化 动态 线性 布局 的 循环 视图 

) 


/ 初始 化 动态 线性 布局 的 循环 视图 

private void initRecyclerDynamic() { 
// 从 布局 文件 中 获取 名 叫 rv_dynamic 的 循环 视图 
Tv_dynamic = findViewById(R.id.rv_dynamic); 
/ 创建 一 个 垂直 方向 的 线性 布局 管理 器 
LinearLayoutManager manager = new LinearLayoutManager( 

this, LinearLayout.VERTICAL, false); 

/ 设置 循环 视图 的 布局 管理 器 
ry_dynamic.setLayout Manager(manager); 
/ 获取 默认 的 所 有 公众 号 信息 队列 
mAllArray = GoodsInfo.getDefaultListO; 
/ 获取 默认 的 当前 公众 号 信息 队列 
mPublicArray = GoodsInfo.getDefaultList(); 
/ 构建 一 个 公众 号 列表 的 线性 适配器 
mAdapter =new LinearDynamicAdapter(this, mPublicArray): 
/ 设置 线性 列表 的 点 击 监听 器 
mAdapter.setOnItemClickListener(this); 
/ 设置 线性 列表 的 长 按 监听 器 
mAdapter.setOnItemLongClickListener(this); 
/ 设置 线性 列表 的 删除 按钮 监听 器 
mAdapter.setOnItemDeleteClickListener(this); 
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/ 给 rv_dynamic 设置 公众 号 线性 适配器 
TV_dynamic.setAdapter(mAdapter); 

// 设置 rv_dynamic 的 默认 动画 效果 
ITV_dynamic.setItemAnimatornew DefaultItemAnimator()); 

/ 给 rv_dynamic 添加 列表 项 之 间 的 空白 装饰 
TV_dynamic.addItemDecoration(new SpacesItemDecoration(1)); 


@Override 
public void onClick(View v) { 
if (v.getld() 一 R.id.btn_recycler add) { 
int position = (int) (Math.random() * 100 % mAllArray.size()); 
GoodsInfo old_item = mAllArray.get(position); 
GoodsInfo new_item = new GoodsInfo(old_item.pic_id, old_item.title, old_item.desc); 
mpPublicArray.add(0, new_item); 
mAdapternotifyItemImserted(0); / 通知 适配器 列表 在 第 一 项 插入 数据 
rv_dynamic.scrollToPosition(0); / 让 循环 视图 滚动 到 第 一 项 所 在 的 位 置 


1 


/ 一 旦 点 击 循环 适配器 的 列表 项 ， 就 触发 点 击 监听 器 的 onItemClick 方法 
public void onItemClick(View view, int position) { 
String desc = String.format(" 您 点 击 了 第 %d 项 ， 标 题 是 %s", position + 1， 
mPublicArray.get(position).title); 
Toast.makeText(this, desc, Toast.LENGTH_SHORT).show(); 
b 


// 一 旦 长 按 循 环 适配器 的 列表 项 ， 就 触发 长 按 监听 器 的 onItemLongClick 方法 
public void onItemLongClick(View view, int position) { 

GoodsInfo item = mPublicArray.get(position); 

item.bPressed = !item.bPressed:; 

mpPublicArray.set(position, item); 

mAdapternotifyItemChanged(position); / 通知 适配器 列表 在 第 几 项 发 生变 更 


/ 一 旦 点 击 循环 适配器 列表 项 的 删除 按钮 ， 就 触发 删除 监听 器 的 onItemDeleteClick 方法 
public void onJtemDeleteClick(View view, int position) { 

mPublicArray.remove(position); 

mAdapternotifyItemRemoved(position); / 通知 适配器 列表 在 第 几 项 删除 数据 


} 
具体 的 演示 效果 如 图 7-37、 图 7-38、 图 7-39、 图 7-40 所 示 。 其 中 ,图 7-37 所 示 为 页 面 的 
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初始 截图 ; 在 列表 顶部 新 增 一 条 消息 的 截图 ， 消 息 添加 时 其 实 是 有 动画 的 ， 图 7-38 所 示 为 动 
画 结束 之 后 的 界面 ， 图 7-39 所 示 为 长 按 某 条 消息 时 的 截图 ， 有 iphone 的 同学 可 以 打开 微 信 ， 
长 按 里 面 的 某 条 聊天 记录 ,看 看 是 不 是 在 记录 右边 弹出 “删除 该 聊天 ”按钮 ; 点 击 “ 删 除 该 聊 
天 ”会 展示 记录 的 删除 动画 ， 动 画 结束 的 界面 如 图 7-40 所 示 。 










北方 周末 
可 日 报 
测报 一 
北方 周末 
SN 


© 


图 7-37 消息 的 初始 页 面 图 7-38 新 增 了 一 条 消息 
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图 7.39 长 按 某 条 消息 的 页 面 图 740 删除 该 消息 的 页 面 
7.5 材质 设计 库 


MaterialDesign 材质 设计 库 是 Android 在 界面 设计 方面 做 出 重大 提升 的 增强 库 ， 该 库 提 供 
了 协调 布局 CoordinatorLayout 、 应 用 栏 布 局 AppBarLayout、 可 折 车 工具 栏 布局 
CollapsingToolbarLayout 等 等 新 颖 控件 ， 本 节 就 对 这 些 材质 设计 的 新 控件 进行 详细 的 说 明 。 
7.5.1 协调 布局 CoordinatorLayout 

Android 自 5.0 之 后 对 UI 做 了 较 大 的 提升 ， 一 个 重大 的 改进 是 推出 了 MaterialDesign 库 ， 
而 该 库 的 基础 即 为 协调 布局 CoordinatorLayout， 几 乎 所 有 的 design 控件 都 依赖 于 该 布局 。 所 
谓 协 调 布局 ， 指 的 是 内 部 控件 互相 之 间 存 在 着 动作 关联 ， 比 如 在 A 视图 的 位 置 发 生变 化 之 时 ， 
B 视图 的 位 置 也 按照 某 种 规则 来 变化 ， 仿 佛 弹 钢琴 有 了 协奏曲 一 般 。 
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使 用 协调 布局 CoordinatorLayout 时 ， 要 注意 以 下 两 点 步骤 : 


人 1i 需要 给 模块 导入 design 库 , 即 修改 build.gradle, 在 dependencies 节点 中 加 入 下 面 一 行 表 
示 导 入 design 库 : 





implementation 'com.android.supportdesign:28.0.0” 


(302 根 布局 采用 android.support.design.widget.CoordinatorLayout， 且 该 节点 要 添加 命名 空间 
声明 xmlns:app="http://schemas.android.com/apk/res-auto" 。 使 用 了 协调 布局 的 具体 XML 文件 示例 如 下 : 





<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="(@+id/cl_ main" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 
<!-- 此 处 省 略 内 部 的 视图 节点 --> 

</android.support.design.widget.CoordinatorLayout> 


协调 布局 CoordinatorLayout 继承 自 ViewGroup， 它 的 实现 效果 类 似 于 相对 布局 
RelativeLayout， 若 要 指定 子 视图 在 整个 页 面 中 的 位 置 ， 则 有 以 下 几 个 办 法 : 


e@ 使 用 layout_gravity 属性 ， 指 定子 视图 在 CoordinatorLayout 内 部 的 对 齐 方式 。 

e@ 使 用 app:layout_anchor 和 app:layout_anchorGravity 属性 ， 指 定子 视图 相对 于 其 他 子 视 图 
的 位 置 。 其 中 app:layout anchor 表示 当前 以 哪个 视图 做 为 参照 物 ， 
app:layout_anchorGravity 表示 本 视图 相对 于 参照 物 的 对 齐 方式 。 

e。 使 用 app:layout_behavior 属性 ， 指 定子 视图 相对 于 其 他 视图 的 行为 ， 当 对 方 的 位 置 发 生 
变化 时 ， 本 视图 的 位 置 也 要 随 之 相应 变化 。 


接 下 来 为 了 说 明 协调 布局 的 “协调 ”含义 ， 先 来 看 看 一 个 具体 的 例子 ， 这 个 例子 用 到 了 
悬浮 按钮 FloatingActionButton。 悬 浮 按 钮 是 design 库 提供 的 一 个 特效 按钮 ， 它 继承 自 图 像 按 
钮 ImageButton， 除 了 图 像 按 钮 的 所 有 功能 之 外 ， 还 提供 了 以 下 的 额外 功能 : 


(1) 悬浮 按钮 会 悬浮 在 其 他 视图 之 上 ， 即 使 布局 文件 中 别 的 视图 在 它 后 面 ， 悬 浮 按钮 也 
仍然 显示 在 最 前 面 。 
(2) 在 隐藏 和 显示 悬浮 按钮 之 时 会 播放 切换 动画 ， 其 中 隐藏 按钮 操作 调用 了 hide 方法 ， 
显示 按钮 操作 调用 了 show 方法 。 
(3) 悬浮 按钮 默认 会 随 着 便签 条 Snackbar 的 出 现 或 消失 而 动态 调整 位 置 。 
下 面 是 演示 协调 布局 之 中 悬浮 按钮 与 便签 条 联动 的 布局 文件 例子 : 
<android.support.design.widget.CoordinatorLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/cl_ main" 
android:layout_width="match_parent" 
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android:layout_height="match parent" > 


<Button 
android:id="(@+id/btn_snackbar" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_marginTop="30dp" 
android:text=" 显 示 简 单 提示 条 " 
android:textColor="(@color/black" 
android:textSize="17sp" /> 


<android.support.design.widget.FloatingActionButton 

android:id="(@+id/fab_btn" 
android:layout_width="80dp" 
android:layout_height="80dp" 
android:layout_margin="20dp" 
app:layout_anchor="(@id/ll_ main" 
app:layout_anchorGravity="bottomlright" 
android:background="(@drawable/float_btn" /> 

</android.support.design.widget.CoordinatorLayout> 


与 上 述 布 局 对 应 的 演示 代码 很 简单 ， 仅 仅 在 点 击 按钮 时 弹出 便签 条 ， 调 用 代码 如 下 : 


public class CoordinatorActivity extends AppCompatActivity implements OnClickListener { 





@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_coordinator); 
findViewById(R.id.btn_snackbar).setOnClickListener(this); 


@Override 
public void onClick(View v) { 
if (v.getId() 一 R.id.btn_snackbar) { 
// 在 屏幕 底部 弹出 一 行 提示 条 ， 注 意 悬 浮 按钮 也 会 跟着 上 浮 
Snackbarmake(cl_ main, "这 是 个 提示 条 ", SnackbarLENGTH LONG).show0; 


} 


由 于 便签 条 在 屏幕 底部 弹出 之 后 ， 短 暂停 留 几 秒 便 收缩 消失 ， 如 此 一 进 一 出 之 间 ， 即 可 
观察 悬浮 按钮 与 便签 条 的 协调 联动 。 具 体 的 悬浮 按钮 位 置 变化 效果 如 图 7-41 到 图 7-42 所 示 ， 
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其 中 图 7-41 展示 了 便签 条 弹出 之 前 的 界面 ， 此 时 悬浮 按钮 位 于 屏幕 右 下 方 ; 图 7-42 展示 了 便 
签 条 弹出 之 后 的 界面 , 此 时 悬浮 按钮 随 着 便签 条 一 齐 向 上 抬升 了 一 段 距离 ; 便签 条 回 缩 之 后 的 
界面 跟 图 7-41 是 一 样 的 ， 此 时 旺 浮 按钮 跟着 下 移 ， 并 恢复 到 原来 的 屏幕 位 置 。 


图 7-41 便签 条 未 弹出 时 的 界面 图 7-42 便签 条 弹出 之 后 的 界面 
7.5.2 ”应 用 栏 布局 AppBarLayout 


前 面 几 节 提 到 Android 推出 工具 栏 Toolbar 用 来 替代 ActionBar, 使 得 导航 栏 的 灵活 性 和 易 
用 性 大 大 增强 。 可 是 仅仅 使 用 Toolbar 的 话 , 还 是 有 些 采 板 ， 比 如 说 Toolbar 固定 占据 着 页 面 项 端 ， 
既 不 能 跟着 页 面 主体 移 上 去 ， 也 不 会 跟着 页 面 主体 拉 下 来 。 为 了 让 App 页 面 更 加 生动 活泼 ， 势 必 
要 求 Toolbar 在 某 些 特定 的 场景 上 移 或 者 下 拉 , 如 此 才能 满足 酷 炫 的 页 面 特效 需求 。 为 此 , Android 
5.0 推出 MaterialDesign 库 ， 通 过 该 库 中 的 协调 布局 和 本 小 节 要 介绍 的 应 用 栏 布局 AppBarLayout， 
将 这 两 种 布局 结合 起 来 对 Toolbar 加 以 包装 ， 从 而 实现 项 部 导航 栏 的 动态 变化 效果 。 
应 用 栏 布局 AppBarLayout 其 实 继承 自 线性 布局 LinearLayout, 所 以 它 具 备 了 LinearLayout 
的 所 有 属性 与 方法 ， 除 此 之 外 ， 应 用 栏 布局 的 额外 功能 主要 有 以 下 几 点 : 
(1) 支持 响应 页 面 主体 的 滑动 行为 ， 即 在 页 面 主体 进行 上 移 或 者 下 拉 时 ，AppBarLayout 
能 够 捕捉 到 页 面 主体 的 滚动 操作 。 
(2) 捕捉 到 滚动 操作 之 后 ， 还 要 通知 头 部 控件 通常 是 Toolbar) ， 告 诉 头 部 控件 你 要 怎 
么 滚 ， 是 爱 咋 咋 滚 ， 还 是 满 大 街 滚 。 
顶部 导航 栏 的 动态 滚动 效果 具体 到 实现 上 ， 则 要 在 App 工程 中 做 如 下 修改 : 
Jo1 在 build.gradle 中 添加 几 个 库 的 编译 支持 ， 包 括 appcompat-v7 库 (Toolbar 需要 )、design 
库 (AppBarLayout 需要 )、recyclerview 库 〈 主 页面 的 RecyclerView 需要 )。 
人 2 布局 文件 的 根 布局 采用 CoordinatorLayout， 因 为 design 库 的 动态 效果 都 依赖 于 该 控件 ; 
并 且 该 节点 要 添加 命名 空间 声明 xmlns:app="http://schemas.android.com/apk/res-auto"。 





















































03 使 用 AppBarLayout 节点 包 庄 Toobar 节点 ， 也 就 是 将 Toobar 节点 作为 AppBarLayout 节 
点 的 下 级 节点 。 

人 4 给 Toobar 节点 添加 滚动 属性 app:layout_scrollFlags="scrolllenterAlways"， 指 定 工具 栏 的 
滚动 行为 标志 。 

3705 演示 界面 的 页 面 主体 使 用 RecyclerView 控件 ， 并 给 该 控件 节点 添加 行为 属性 即 














app:layout_behavior="(@string/appbar_scrolling view_behavior" ， 表 示 通 知 AppBarLayout 捕捉 
RecyclerView 的 滚动 操作 。 


下 面 是 AppBarLayonut 结合 RecyclerView 的 布局 文件 例子 : 
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<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match parent" 
android:layout_height="match parent" > 


<android.support.design.widget.AppBarLayout 
android:id="@+id/abl_ title" 
android:layout_width= "match_ parent" 
android:layout_height="wrap_content" > 


<android.support.v7.widget.Toolbar 
android:id="(@+id/tl title" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="(@color/blue_light" 
app:layout_scrollFlags="scrolllenterAlways" /> 
</android.support.design.widget.AppBarLayout> 


<android.support.v7.widget.RecyclerView 
android:id="(@+id/rv_main" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="(@string/appbar_scrolling_view_behavior" /> 
</android.support.design.widget.CoordinatorLayout> 


与 上 述 布 局 文件 对 应 的 页 面 代码 如 下 : 


public class AppbarRecyclerActivity extends AppCompatActivity { 
private String[] yearArray = {" 鼠 年 ", " 牛 年 ", " 虎 年 ", " 免 年 ", " 龙 年 ", " 蛇 年 ", 
" 马 年 "," 举 年 "" 狼 年 "," 鸡 年 "," 狗 年 "," 猪 年 "); 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_appbar_recycler); 
// 从 布局 文件 中 获取 名 叫 tl_title 的 工具 栏 
Toolbar tl title = findViewById(R.id.tl_ title); 
/ 使 用 tLtitle 蔡 换 系统 自 带 的 ActionBar 
setSupportActionBar(t] title); 
/ 从 布局 文件 中 获取 名 叫 rv_main 的 循环 视图 
RecyclerView rv_main = findViewById(R.idrv_main); 
/ 创建 一 个 垂直 方向 的 线性 布局 管理 器 
LinearLayoutManager llm = new LinearLayout Manager(this, LinearLayout.VERTICAL, false); 
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/ 设置 循环 视图 的 布局 管理 器 

ry_main.setLayout Manager(llm); 

/ 构建 一 个 十 二 生肖 的 线性 适配器 

RecyclerCollapseAdapter adapter = new RecyclerCollapseAdapter(this, yearArray); 
/ 给 rv_main 设置 十 二 生肖 线性 适配器 

rv_main.setAdapter(adapter); 


b 


应 用 栏 布局 配合 循环 视图 的 演示 效果 如 图 7-43 到 图 7-45 所 示 ， 其 中 图 7-43 展示 了 打开 
演示 页 的 初始 画面 ， 此 时 工具 栏 位 于 页 面 项 部 ， 图 7-44 展示 了 上 拉 一 小 段 时 的 画面 ， 此 时 工 
有 具 栏 随 着 向 上 滚动 了 一 段 ; 图 7-45 展示 了 上 拉 一 大 段 时 的 画面 ， 此 时 工具 栏 滚动 到 屏幕 之 外 ， 
完全 看 不 见 了 。 

te Toxic ao 


group 1 最 征 
1 鼠 年 
1 好 年 
2 牛 年 
2 牛 年 
2 牛 年 
3 虎 征 
3 虎 年 
3 虎 征 
4 免 年 


图 7-43 ”应 用 栏 的 初始 界面 7-44 上 拉 一 小 段 的 循环 视图 。 图 7-45 上 拉 一 大 段 的 循环 视图 


虽说 通过 AppBarLayout 能 够 实现 Toolbar 的 滚动 效果 ， 但 并 非 所 有 可 滚动 的 控件 都 会 触 
发 Toolbar 滚动 ,事实 上 只 有 Android 5.0 之 后 新 增 的 少数 滚动 控件 才 具 备 该 特技 .RecyclerView 
是 身 怀 绝技 的 其 中 之 一 ， 它 可 用 来 替代 列表 视图 ListView 和 网 格 视图 GridView; 而 替代 滚动 
视图 ScrollView 的 另 有 其 人 ， 它 便 是 嵌 套 滚动 视图 NestedScrollView， 在 Android 5.0 之 后 的 
v4 库 中 提供 。 

NestedScrollView 继承 自 框 架 布 局 FrameLayout， 其 用 法 与 ScrollView 相似 ， 例 如 都 必须 
且 只 能 带 一 个 直接 子 视图 、 都 是 允许 内 部 视图 上 下 滚动 等 等 。 NestedScrollView 多 出 来 的 功能 ， 
则 是 跟 AppBarLayout 配合 使 用 ， 夭 由 触发 Toolbar 的 滚动 行为 ， 因 此 可 把 它 当 作 是 兼容 了 
Android 5.0 新 特性 的 增强 版 ScrollView。 因 为 NestedScrollView 在 布局 和 代码 中 使 用 的 情况 与 
ScrollView 基本 相同 ， 所 以 这 里 就 不 再 喝 嗪 它 的 详细 用 法 了 ， 有 兴趣 的 读者 可 参考 本 书 附 带 源 
码 中 group 模块 的 AppbarNestedActivity.java。 
7.5.3 ”可 折叠 工 具 栏 布 局 CollapsingToolbarLayout 

上 一 小 节 阐述 了 如 何 把 Toolbar 往 上 滚动 ， 那 反 过 来 ， 能 不 能 把 Toolbar 往 下 拉动 呢 ? 这 
里 要 明确 一 点 ，Toolbar 本 身 是 页 面 顶 部 的 工具 栏 ， 其 上 没有 当前 页 面 的 其 他 控件 了 。 假 如 
Toolbar 拉 下 来 , 那 Toolbar 上 面 的 室 白 该 显示 什么 ? 所 以 Toolbar 的 上 部 边缘 是 不 可 以 往 下 拉 
的 ， 只 有 下 部 边缘 才能 往 下 拉 ， 这 样 的 视觉 效果 好 比 Toolbar 如 电影 幕布 一 般 缓 缓 向 下 展 
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不 过 ，Android 在 实现 导航 栏 展开 效果 的 时 候 ， 并 非 直 接 让 Toolbar 展开 或 收缩 ， 而 是 另 
外 提供 了 可 折 著 工具 栏 布局 CollapsingToolbarLayout， 通 过 该 布局 节点 包 庄 Toolbar 节点 ， 从 
而 控制 导航 栏 的 展开 和 收缩 行为 。 

若 要 在 App 工程 中 使 用 CollapsingToolbarLayout， 则 需 注意 以 下 几 点 修改 : 

EDi 在 build.gradle 中 添加 几 个 库 的 编译 支持 , 包括 appcompat-v7 库 (Toolbar 需要 )、design 
库 (CollapsingToolbarLayout 需要 )、recyclerview 库 (主页 面 的 RecyclerView 需要 )。 

和 302 布局 文件 的 根 布局 采用 CoordinatorLayout， 因 为 design 库 的 动态 效果 都 依赖 于 该 控件 ; 
并 且 该 节点 要 添加 命名 空间 声明 xmlns:app="http://schemas.android.com/apk/res-auto"。 

人 3 使 用 AppBarLayout 节 点 包 衷 CollapsingToolbarLayout 节 点 ,再 在 CollapsingToolbarLayout 
节点 下 添加 Toobar 节点 。 

人 4 给 Toobar 节点 添加 滚动 属性 app:layout_scrollFlags="scrolllenterAlways"， 声 明 工具 栏 的 
滚动 行为 标志 。 

人 5 演示 界面 的 页 面 主体 使 用 RecyclerView 控件 或 者 NestedScrollView 控件 , 并 给 该 控件 节 
点 添加 行为 属性 即 app:layout behavior="(@string/appbar scrolling view_behavior' ， 表 示 通 知 
AppBarLayout 捕捉 RecyclerView 的 滚动 操作 。 


App 在 运行 的 时 候 ，Toolbar 的 高 度 是 固定 不 变 的 ， 会 发 生 高 度 变化 的 布局 其 实 是 
CollapsingToolbarLayout。 只 是 许多 App 把 这 两 者 的 背景 设 为 一 种 颜色 ， 所 以 看 起 来 像 是 统一 
的 标题 栏 在 收缩 和 展开 。 既然 二 者 原本 不 是 一 家 , 那么 就 得 有 新 的 属性 用 于 区 分 它们 内 部 的 行 
为 ， 新 属性 有 两 个 ， 分 别 说 明 如 下 : 

1. 折叠 模 式 属性 

该 属性 的 名 称 为 app:layout_collapseMode， 它 指定 了 子 视图 (通常 是 Toolbar) 的 折 车 模 
式 ， 折 和 登 模式 的 取 值 说 明 见 表 7-3。 

表 7-3 可 折叠 工具 栏 布 局 的 折叠 模式 取 值 说 明 

































































折叠 模式 取 值 





固定 模式 。Toolbar 固定 不 动 ， 不 受 CollapsingToolbarLayout 的 折 秋 影响 

parallax 视差 模式 。 随 着 CollapsingToolbarLayout 的 收缩 与 展开 ，Toolbar 也 跟着 收缩 与 展开 。 折 县 
系数 可 通过 属性 app:layout_collapseParallaxMultiplier 配置 , 该 属性 为 1.0 时 , 折 半 效果 同 pin 
模式 即 固定 不 动 : 该 属性 为 0.0 时 ， 折 县 效果 等 同 于 none 模式 ， 即 也 跟着 移动 相同 距离 

none 默认 值 。CollapsingToolbarLayout 折 肢 多 少 距离 ， 则 Toolbar 也 随 着 移动 多 少 距离 ， 通 俗 地 

说 ， 就 是 夫 唱 妇 随 


2. 折 又 距离 系数 属性 


该 属性 名 称 为 app:layout_collapseParallaxMnultiplier, 它 指定 了 视差 模式 时 的 折 辣 距离 系数 ， 
取 值 在 0.0 到 1.0 之 间 。 如 不 明确 指定 ， 则 该 属性 值 则 默认 为 0.5。 
为 了 区 分 这 几 种 折 芭 模式 之 间 的 差异 ， 下 面 来 个 演示 pin 固定 模式 使 用 的 布局 文件 例子 : 


<android.support.design.widget.CoordinatorLayout 
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Xmlns:android="http:/schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match parent" 
android:layout_height="match parent" > 


<android.support.design.widget.AppBarLayout 
android:id="(@+id/abl title" 
android:layout_width="match_parent" 
android:layout_height="160dp" 
android:background="(@color/blue light" > 


<android.support.design.widget.CollapsingToolbarLayout 
android:id="(@+id/ctl_title" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:title=" 欢 乐 中 国 年 " 
app:layout_scrollFlags="scrolllexitUntilCollapsed" 
app:contentScrim="?attr/colorPrimary" 
app:expandedTitleMarginStart="40dp" > 


<!-- 注意 属性 layout_collapseMode 作用 于 Toolbar 控件 --> 
<android.support.v7.widget.Toolbar 
android:id="(@+id/tl title" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize”" 
android:background="(@color/red" 
app:layout_collapseMode="pin" /> 
</android.support.design.widget.Collapsing ToolbarLayout> 
</android.support.design.widget.AppBarLayout> 


<android.support.v7.widget.RecyclerView 
android:id="(@+id/rv_main" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="(@string/appbar_scrolling_view_behavior" 亡 
</android.support.design.widget.CoordinatorLayout> 


对 应 的 页 面 代 码 可 采用 上 一 小 节 的 逻辑 ， 除 了 布局 变更 之 外 ， 其 他 可 不 做 改动 。 采 取 pin 
固定 模式 的 导航 栏 变化 效果 如 图 7-46 到 图 7-48 所 示 , 其 中 图 7-46 展示 了 刚 打开 页 面 时 的 初始 
画面 ， 此 时 导航 栏 完 全 展开 ; 图 7-47 展示 了 往 上 拉动 一 小 段 后 的 画面 ， 此 时 导航 栏 下 半 部 分 
向 上 收缩 ,标题 文字 随 之 上 移 ， 而 上 半 部 分 红色 的 Toolbar 保持 不 变 ; 图 7-48 展示 了 往 上 拉动 

-大 段 后 的 画面 , 此 时 导航 栏 下 半 部 分 完全 消失 , 标题 文字 全 部 移入 上 半 部 分 红色 的 Toolbar。 





医 | 
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欢乐 中 国 年 1 最 年 
欢乐 中 国 年 

1 好 年 二 
| 鼠 年 

二 牛 年 3 席 年 
2 牛 年 


图 7-46 固定 模式 下 的 导航 栏 图 747 上 拉 一 小 段 时 的 导航 栏 ” 图 748 上 拉 一 大 段 时 的 导航 栏 
接 下 来 继续 演示 parallax 视差 模式 , 只 要 把 原 布 局 中 的 Toolbar 节点 蔡 换 为 下 面 内 容 即 可 : 
<android.support.v7.widget.Toolbar 
android:id="(@-+Hid/tl title" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="(@color/red" 
app:layout_collapseMode="parallax" 
app:layout_collapseParallaxMultiplier="0.1" /> 


采取 parallax 视差 模式 的 导航 栏 变化 效果 如 图 7-49 到 图 7-51 所 示 , 其 中 图 7-49 展示 了 刚 
打开 页 面 时 的 初始 画面 ， 此 时 导航 栏 完全 展开 ， 图 7-50 展示 了 往 上 拉动 一 小 段 之 后 的 画面 ， 
此 时 导航 栏 下 半 部 分 向 上 收缩 ， 标 题 文字 随 之 上 移 ， 且 上 半 部 分 红色 的 Toolbar 也 按照 比例 向 
上 收缩 ; 图 7-51 展示 了 往 上 拉动 一 大 段 之 后 的 画面 ， 此 时 导航 栏 下 半 部 分 完全 消失 ， 标 题 文 
字 全 部 移入 顶部 ， 且 上 半 部 分 红色 的 Toolbar 也 从 屏幕 上 消失 。 





欢乐 中 国 年 1 好 年 
欢乐 中 国 年 
1 好 年 和 二 
1 好 征 
S 2 3 虎 年 
2 和 年 


图 7-49 视差 模式 的 初始 界面 图 7-50 上 拉 一 小 段 时 的 导航 栏 。 图 7-51 上 拉 一 大 段 时 的 导航 栏 


7.6 实战 项 目 : 仿 支付 宝 的 头 部 伸缩 特效 





上 一 节 的 材质 设计 看 起 来 固然 有 些 奇妙 ， 可 是 似乎 实战 意义 不 大 ， 倘 若 仅 仅 为 了 炫 技 ， 
那 也 只 能 归于 中 看 不 中 用 的 花 拳 绣 腿 之 流 。 有 道 是 天 生 我 材 必 有 用 , 在 广泛 使 用 的 App 当中 ， 
有 不 少 采 取 了 MaterialDesign 的 框架 。 辟 如 常见 的 支付 宝 App， 通 过 材质 设计 结合 工具 栏 
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Toolbar， 能 够 实现 项 部 导航 栏 动态 伸缩 的 效果 ， 下 面 就 来 看 看 支付 宝 的 头 部 伸缩 特效 是 怎样 
实现 的 。 


7.6.1 设计 思 


手机 屏幕 不 比 电脑 屏幕 ， 不 管 手机 配置 多 高 ， 屏 幕 都 不 可 能 增加 太 大 ， 因 为 人 的 手掌 只 
有 这 么 宽 , 盘 手 可 握 的 尺寸 撑 死 了 也 没 多 大 。 于 是 既 要 在 有 限 的 方寸 之 间 展 示 充 分 的 信息 , 又 
要 保留 足够 的 入 口 捷径 供用 户 跳 转 ， 实 在 是 一 个 两 难 的 局 面 。 每 当 遇 到 这 种 左右 为 难 的 场合 
通常 的 做 法 是 相互 妥协 ， 就 App 的 界面 设计 而 言 ， 可 分 为 下 列 两 种 情况 。 

(1) 一 种 是 刚 打开 App 页 面 的 时 候 ， 此 时 优先 展示 各 种 入 口 按 钮 ， 方 便 用 户 直 达 对 应 的 
功能 页 ; 

(2) 另 一 种 情况 是 用 户 上 拉 App 页 面 ， 此 时 明显 用 户 想 要 了 解 下 方 的 分 类 信息 ， 那 么 应 
当 将 导航 入 口 最 小 化 ， 从 而 腾 出 空间 用 于 展示 详细 的 图 文 。 


以 大 家 熟悉 的 支付 宝 App 为 例 , 它 的 首 屏 头 部 便 分 情况 显示 , 具体 且 看 如 图 7-52 和 图 7-53 
所 示 的 两 张 头 部 仿制 效果 。 其 中 图 7-52 为 支付 宝 的 标题 栏 完 全 展开 时 的 界面 ， 此 时 页 面 头 部 
的 导航 栏 占据 了 较 大 部 分 的 高 度 ; 而 图 7-53 为 支付 宝 的 标题 栏 完全 收缩 时 的 界面 ， 此 时 头 部 
导航 栏 只 剩 矮 矮 的 一 个 长 条 。 


〇 @ 搜索 商品 





[本 由 由 


扫 一 扫 付 一 付 聊 一 聊 


转账 转账 转账 转账 





图 7-52 仿 支 付 宝 首 页 的 头 部 展开 效果 图 7-53 仿 支 付 宝 首页 的 头 部 缩 起 效果 


上 面 的 头 部 展开 和 收缩 效果 ， 正 是 材质 设计 所 具备 的 技能 ， 因 此 这 个 可 伸缩 的 头 部 特效 
必定 少不了 下 列 的 几 个 控件 。 


协调 布局 CoordinatorLayout: 协调 布局 是 材质 设计 所 有 特效 的 基础 。 

工具 栏 Toolbar: 顶部 导航 栏 必 选 Toolbar。 

应 用 栏 布局 AppBarLayout: 要 想 让 Toolbar 下 拉 或 者 上 拉 , 还 得 靠 AppBarLayout 来 帮忙 

可 折 且 工具 栏 布局 CollapsingToolbarLayout: 工具 栏 上 下 伸缩 之 时 ， 若 要 展示 折 营 效果 ， 

则 需 CollapsingToolbarLayout。 

@ 循环 视图 RecyclerView: 不 管 是 头 部 的 网 格 入 口 ， 还 是 下 方 的 信息 列表 ， 都 会 用 到 循环 
视图 。 

。 吝 套 滚动 视图 NestedScrollView: 下 方 的 信息 区 域 ， 有 可 能 容纳 多 种 样式 的 布局 ， 这 时 
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就 要 采用 谋 套 滚动 视图 作为 容器 了 。 


虽然 本 实战 项 目 仅 仅 模拟 支付 宝 的 头 部 区 域 ， 但 是 光 光 一 个 头 部 就 牵涉 到 诸多 知识 点 ， 
看 来 方寸 之 间 的 学 问 可 不 小 哟 。 


7.6.2 小 知识 : 导航 栏 的 滚动 标志 


前 面 介绍 AppBarLayout 和 CollapsingToolbarLayout 用 法 的 时 候 ， 演 示 的 几 个 布局 文件 都 
用 到 了 app:layout scrollFlags 属性 ， 并 且 有 时 候 取 值 为 "scrolllenterAlways"， 有 时 候 取 值 为 
"scrolllexitUntilCollapsed"， 这 是 为 什么 呢 ? 其 实 这 个 滚动 标志 属性 来 自 于 AppBarLayout， 它 
用 来 定义 下 级 控件 的 具体 滚动 行为 ， 比 如 说 是 先 滚 还 是 后 滚 ,是 滚 一 半 还 是 全 部 滚 ， 是 自动 滚 
还 是 手动 滚 等 等 。 

首先 得 弄 清楚 为 什么 AppBarLayout 划分 了 这 几 种 滚动 行为 ， 所 谓 知 其 然 ， 还 要 知 其 所 以 
然 ， 才 更 有 利于 记忆 和 理解 。 下 面 是 可 能 产生 不 同 滚动 行为 的 几 种 场景 : 

(1) AppBarLayout 的 滚动 依赖 于 页 面 主体 的 滚动 ， 与 页 面 主体 相对 应 的 ， 可 将 
AppBarLayout 称 作 页 面 头 部 。 既 然 一 个 页 面 分 为 头 部 和 主体 两 部 分 ， 那 么 就 存在 谁 先 滚 谁 后 
滚 的 问题 了 。 

(2) AppBarLayout 内 部 的 高 度 也 可 能 变化 ， 比 如 它 骸 套 了 可 折 爱 工具 栏 布 局 
CollapsingToolbarLayout。 既 然 AppBarLayonut 的 高 度 是 变化 的 , 那 也 得 区 分 是 滚 一 半 还 是 滚 全 
部 。 

(3) AppBarLayout 被 拉动 了 一 段 还 没 拉 完 ， 此 时 一 旦 松 开 手指 ， 一 般 是 就 地 停 住 。 但 半 
路 刹车 有 碍 观瞻 ， 那 么 就 得 判断 是 继续 停 着 不 动 ， 还 是 继续 向 上 收缩 ， 或 是 继续 向 下 展开 。 

根据 上 面 列举 的 三 种 滚动 场景 , AppBarLayout 给 子 控件 设 定 了 五 个 滚动 标志 , 包括 scroll、 
enterAlways、exitUntilCollapsed、enterAlwaysCollapsed 和 snap， 分 别 介绍 如 下 : 


1. scroll 

该 标志 表示 头 部 与 主体 一 起 滚动 。 
2.enterAlways 
该 标志 表示 头 部 与 主体 先 一 起 滚动 ， 头 部 滚 到 位 后 ， 主 体 继续 向 上 或 者 向 下 滚 。 





3. exitUntilCollapsed 

该 标志 保证 页 面 上 至 少 能 看 到 最 小 化 的 工具 栏 ， 不 会 完全 看 不 到 工具 栏 。 具 体 的 滚动 行 
为 分 成 向 上 滚动 和 向 下 滚动 两 种 , 其 中 向 上 滚动 表示 头 部 先 往 上 收缩 ,一 直 滚 到 折 登 的 最 小 高 
度 ; 然后 头 部 固定 不 动 , 主体 继续 向 上 滚动 ; 而 向 下 滚动 表示 头 部 固定 不 动 , 主体 先 向 下 滚动 ， 
一 直 滚 到 主体 全 部 拉 出 ， 然 后 头 部 向 下 展开 。 

4.enterAlwaysCollapsed 


该 标志 一 般 跟 enterAlways 一 起 使 用 ， 它 与 enterAlways 的 区 别 在 于 有 折合 操作 ， 而 单独 
的 enterAlways 没有 折 站 。 具 体 的 滚动 行为 也 分 成 向 上 滨 动 和 向 下 滚动 两 种 ， 其 中 向 上 深 动 表 
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示 头 部 先 往 上 收缩 ， 一 直 滚 到 折 倒 的 最 小 高 度 ;， 然后 头 部 与 主体 先 一 起 滚动 ， 头 部 滚 到 位 后 ， 
主体 继续 向 上 。 而 向 下 深 动 表示 头 部 与 主体 先 一 起 滚动 ， 一 直 深 到 头 部 折合 的 最 小 高 度 ; 然后 
主体 向 下 滚动 ， 滚 到 位 后 头 部 继续 向 下 展开 。 


5. snap 


在 用 户 手指 松 开 时 ， 系 统 自 行 判 断 ， 接 下 来 是 全 部 向 上 滚 到 项 ， 还 是 全 部 向 下 展开 。 

说 实话 ， 这 五 种 滚动 标志 展示 起 来 都 差不多 ， 光 看 静态 的 截图 难以 分 辩 其 中 的 差异 ， 建 
议 读者 运行 本 书 附带 源码 group 模块 的 ScrollFlagActivity.java， 再 加 以 观察 。 为 了 观察 的 时 候 
有 的 放 矢 ， 笔 者 整理 了 一 份 5 种 标志 相互 之 间 的 区 别 列表 ， 有 具体 详 见 表 7-4。 


表 7-4 5 种 滚动 标志 互相 之 间 的 区 别 
滚动 标志 取 值 说 明 
简单 朴素 的 滚动 ， 没 什么 花样 
该 标志 与 scroll 的 区 别 在 于 ， 它 会 让 头 部 盖 住 主体 ， 而 scroll 不 会 盖 住 
设置 该 标志 后 ， 页 面 上 总 会 看 到 工具 栏 
该 标志 与 enterAlways 的 区 别 在 于 ， 它 支持 layout_collapseMode 设 定 的 折 有 效果 
设置 该 标志 后 ， 每 当 用 户 松 开 手 势 ， 系 统 会 自动 判断 是 向 上 收缩 ， 还 是 向 下 展开 











scroll 










enterAlways 
exitUntilCollapsed 
enterAlwaysCollapsed 






7.6.3 ”代码 示例 


仿 支付 宝 头 部 的 实战 项 目 ， 用 到 的 几 个 控件 均 需 导入 相应 的 兼容 库 ， 故 而 编码 过 程 与 前 
两 章 相 比 多 了 一 步 ， 共 分 为 6 步 : 
C0) 设计 代码 架构 ， 初 步 拆 分 后 的 package 包 架构 如 下 : 


com.example.alipay.activity: 存放 Acitivity 页 面 的 代码 。 
com.example.alipay.adapter: 存放 适配器 的 代码 。 
com.example.alipay.bean: 存放 实体 数据 结构 的 代码 ， 如 生活 信息 。 
com.example.alipay.util: 存放 工具 类 的 代码 。 


人 ER2 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 App 主页 面 的 代码 文件 取 名 
ScrollAlipayActivityjava， 对 应 的 布局 文件 名 是 activity_scroll_alipayxml。 另 外 还 有 循环 适配器 的 代码 
及 其 布局 文件 。 

ER3 打开 build.gradle, 在 dependencies 节点 中 加 入 下 面 三 行 表示 分 别 导入 appcompat-v7( 工 
具 栏 需要 )、design (材质 设计 库 需 要 )、recyclerview-v7 (循环 视图 需要 ) 3 个 库 : 








implementation 'com.android.support:appcompat-v7:28.0.0” 
implementation 'com.android.support:design:28.0.0” 
implementation 'com.android.support:recyclerview-v7:28.0.0° 
304 在 AndroidManifestxml 中 补充 相应 配置 ， 即 注册 仿 支 付 宝 页 面 的 acitivity 节点 , 注册 代 
码 如 下 所 示 : 


<activity android:name=".ScrollAlipayActivity" android:theme="(@style/AppCompatTheme" /> 
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注意 : 这 里 给 activity 节点 补充 了 AppCompatTheme 风格 ， 目 的 是 声明 不 带 ActionBar 的 风格 ， 
以 便 Activity 代码 内 部 使 用 Toolbar 替换 ActionBar。 


C05 在 资源 目录 下 补充 相应 的 xml 配置， 包括: 


(1) 在 res/drawable 目录 下 存放 相关 状态 图 形 的 描述 文件 。 
(2) 在 res/layout 目录 下 编写 页 面 、 适 配器 等 对 应 的 布局 文件 。 
(3) 在 res/values/styles.xml 中 补充 AppCompatTheme 与 标签 按钮 的 样式 定义 。 


G06 进行 java 代码 开发 ， 包 括 页 面 、 适 配器 等 等 的 编码 。 


仿照 支付 宝 首 屏 头 部 的 实现 过 程 , 就 是 定义 一 个 协调 布局 CoordinatorLayout, 然后 柑 套 应 
用 栏 布局 AppBarLayout， 再 远 套 可 折 肝 工具 栏 布局 CollapsingToolbarLayout， 再 典 套 工具 栏 
Toolbar 的 页 面 布局 。 支 付 宝 首页 之 所 以 要 嵌 套 这 么 多 层 ， 是 因为 要 完成 以 下 功能 : 


(1) CoordinatorLayout 嵌 套 AppBarLayout， 这 是 为 了 让 头 部 导航 栏 能 够 跟随 视图 主体 下 
拉 而 展开 ， 并 且 跟 随 视图 主体 上 拉 而 收缩 。 这 个 视图 主体 可 以 是 RecyclerView， 也 可 以 是 
NestedScrollView。 

(2) AppBarLayout 嵌 套 CollapsingToolbarLayout， 这 是 为 了 定义 导航 栏 下 面 需 要 展开 和 
收缩 的 这 部 分 视图 。 

(3) CollapsingToolbarLayout 能 套 Toolbar， 这 是 为 了 声明 导航 栏 上 方 无 论 何 时 都 要 显示 
的 长 条 区 域 ， 其 中 Toolbar 还 要 定义 两 个 不 同 的 下 级 布局 ， 用 于 分 别 显 示 展 开 与 收缩 两 种 状态 
时 的 工具 栏 界 面 。 

下 面 是 基于 以 上 思路 实现 的 仿 支付 宝 首页 布局 文件 例子 : 

<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:fitsSystemWindows="true" > 

















<android.support.design.widget.AppBarLayout 
android:id="(@+id/abl_bar" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:fitsSystemWindows="true" > 


<android.support.design.widget.CollapsingToolbarLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:fitsSystemWindows="true" 
app:layout_scrollFlags="scrolllexitUntilCollapsedlsnap" 
app:contentScrim="(@color/blue_dark" > 
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<!-- life_pay.xml 定义 了 工具 栏 下 方 的 频道 布局 -> 

<include 
android:layout_ width="match_parent" 
android:layout height="wrap_content" 
android:layout marginTop="@dimen/toolbar_ height" 
app:layout_collapseMode= "parallax" 
app:layout_collapseParallaxMultiplier="0.7" 
layout="(@layout/life pay" 亡 


<android.support.v7.widget.Toolbar 
android:layout_width="match_parent" 
android:layout_height="(@dimen/toolbar_height" 
app:layout_collapseMode="pin" 
app:contentInsetLeft="0dp" 
app:contentInsetStart="0dp" > 


<!-- toolbar_expand.xml 定义 了 展开 状态 时 的 工具 栏 内 容 布 局 -> 
<include 
android:id="(@+id/t]_ expand" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
layout="(@layout/toolbar_expand" /> 


<!-- toolbar_collapse.xml 定义 了 收缩 状态 时 的 工具 栏 内 容 布局 -> 
<include 
android:id="(@+id/tl_collapse" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
layout="(@layout/toolbar_collapse" 
android:visibility="gone" /> 
</android.support.v7.widget.Toolbar> 
</android.support.design.widget.Collapsing ToolbarLayout> 
</android.support.design.widget.AppBarLayout> 


<android.support.v7.widget.RecyclerView 
android:id="(@+id/rv_content" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_marginTop="10dp" 
app:layout_behavior="(@string/appbar_scrolling view_behavior" /> 
</android.support.design.widget.CoordinatorLayout> 


296 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


然而 仅仅 实现 上 述 布局 并 非 万 事 大 吉 ， 因 为 支付 宝 首页 的 头 部 在 伸缩 时 可 是 有 动画 效果 
的 ， 就 像 图 7-54 和 图 7-55 那样 的 淡 入 淡出 渐变 动画 。 





图 7-54 头 部 导航 栏 的 淡出 效果 图 7-55 头 部 导航 栏 的 淡 入 效果 
图 7-54 和 图 7-55 所 体现 的 渐变 动画 其 实 可 分 为 两 个 部 分 : 


(1) 导航 栏 从 展开 状态 向 上 收缩 时 ， 头 部 各 控件 要 慢 慢 向 背景 色 过 渡 ， 也 就 是 淡出 效果 。 
(2) 导航 栏 向 上 收缩 到 一 半 ， 项 部 的 工具 栏 要 更 换 成 收缩 状态 下 的 工具 栏 布 局 ， 并 且 随 
着 导航 栏 继续 向 上 收缩 ， 新 工具 栏 上 的 各 控件 也 要 慢 慢 变 得 清晰 起 来 ， 也 就 是 淡 入 效果 。 


如 果 导 航 栏 是 从 收缩 状态 向 下 展开 ， 则 此 时 相应 地 做 上 述 渐变 动画 的 取 反 效果 ， 即 下 面 
的 描述 : 


(1) 导航 栏 从 收缩 状态 向 下 展开 时 ， 头 部 的 各 控件 要 慢 慢 向 背景 色 过 渡 ， 也 就 是 淡出 效 
果 ; 同时 展开 导航 栏 的 下 部 分 布局 ， 并 且 该 布局 上 的 各 控件 渐渐 变 得 清晰 。 

(2) 导航 栏 向 下 展开 到 一 半 ， 顶 部 的 工具 栏 要 更 换 成 展开 状态 下 的 工具 栏 布局 ， 并 且 随 
着 导航 栏 继续 向 下 展开 ， 新 工具 栏 上 的 各 控件 也 要 慢 慢 变 得 清晰 起 来 ， 也 就 是 淡 入 效果 。 


看 文字 描述 起 来 还 比较 复杂 ， 如 果 只 对 某 个 控件 做 渐变 动画 还 好 ， 可 是 导航 栏 上 的 控件 
有 好 几 个 , 而 且 数 量 并 不 固定 ,常常 会 增加 新 控件 或 者 修改 原 控件 。 倘若 要 对 导航 栏 上 的 各 控 
件 逐 一 展示 动画 ， 不 但 花费 力气 ， 而 且 后 期 也 不 好 维护 。 为 了 解决 这 个 动画 问题 ， 可 以 采取 类 
似 遮 单 的 做 法 ， 即 一 开始 先 给 导航 栏 章 上 一 层 透明 的 视图 ,此 时 导航 栏 的 画面 就 完全 显示 ; 然 
后 随 着 导航 栏 的 移动 距离 ,计算 当前 位 置 下 的 遮 单 透明 度 ， 使 该 遮 单 变 得 越 来 越 不 透明 ,看 起 
来 导航 栏 像 是 蒙 上 了 一 层 薄 雾 面纱 ， 蒙 到 最 后 就 完全 看 不 见 了 。 反 过 来 ， 也 可 以 一 开始 给 导航 
栏 章 上 一 层 不 透明 的 视图 ,此 时 导航 栏 的 所 有 控件 都 是 看 不 见 的 ， 然 后 随 着 距离 的 变化 , 遮 单 
变 得 越 来 越 不 透明 ， 导 航 栏 也 会 跟着 变 得 越 来 越 清晰 了 。 

现在 渐变 动画 的 思路 有 了 ， 可 谓 万 事 俱 备 、 只 从 东风 ， 再 摘 一 个 导航 栏 的 位 置 偏 移 监听 
事件 便 行 ， 正 好 有 个 现成 的 监听 器 AppBarLayout.OnOffsetChangedListener， 只 需 给 应 用 栏 布 
局 对 象 调用 addOnOffsetChangedListener 方法 ， 即 可 实现 给 导航 栏 注册 偏 移 监听 器 的 功能 。 接 
下 来 还 是 看 看 下 面具 体 的 实现 代码 吧 : 

public class ScrollAlipayActivity extends AppCompatActivity implements OnOffsetChangedListener { 


第 7 章 ”组合 控 件 


297 





private View tL_expand, tl_collapse; / 分 别 声明 伸展 时 与 收缩 时 的 工具 栏 视图 
private View v_expand_mask, v_collapse_ mask, v_pay_mask; / 分 别 声明 3 个 遮 罩 视 图 
private int mMaskColor;，// 遮 罩 颜 色 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


由 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_scroll alipay); 

/ 获取 默认 的 蓝 色 遮 单 颜色 

mMaskColor = getResources().getColor(R.color.blue_dark); 
// 从 布局 文件 中 获取 名 叫 rv_content 的 循环 视图 
RecyclerView rv_content = findViewById(R.id.rv_content); 
/ 设置 循环 视图 的 布局 管理 器 〈 四 列 的 网 格 布局 管理 器 ) 
IV_content.setLayout Manager(new GridLayout Manager(this, 4)); 
/ 给 rv_content 设置 生活 频道 网 格 适配器 
TV_content.setAdapter(new LifeRecyclerAdapter(this, LifeItem.getDefaultO)); 
/ 从 布局 文件 中 获取 名 叫 abl_bar 的 应 用 栏 布局 
AppBarLayout abl_bar = findViewById(R.id.abl_bar); 

/ 从 布局 文件 中 获取 伸展 之 后 的 工具 栏 视图 

tl expand = findViewById(R.id.tl_ expand); 

/ 从 布局 文件 中 获取 收缩 之 后 的 工具 栏 视图 

tl_collapse = findViewById(R.id.tl_collapse); 

/ 从 布局 文件 中 获取 伸展 之 后 的 工具 栏 遮 单 视图 
Vv_expand _ mask = findViewById(R.id.v_expand_ mask); 

/ 从 布局 文件 中 获取 收缩 之 后 的 工具 栏 遮 罩 视 图 
V_collapse_mask = findViewById(R.id.v_collapse_mask); 

/ 从 布局 文件 中 获取 生活 频道 的 遮 罩 视图 

Vv_pay_mask = findViewById(R.id.v_pay_mask); 

// 给 abl_bar 注册 一 个 位 置 偏 移 的 监听 器 
abl_baraddOnOffsetChangedListener(this); 


/ 每 当 应 用 栏 向 上 滚动 或 者 向 下 滚动 ， 就 会 触发 位 置 偏 移 监听 器 的 onOffsetChanged 方法 
public void onOffsetChanged(AppBarLayout appBarLayout int verticalOffset) { 


int offset = Math.abs(verticalOffset); 

/ 获取 应 用 栏 的 整个 滑动 范围 ， 以 此 计算 当前 的 位 移 比例 

int total = appBarLayout.getTotalScrollRange(); 

int alphaln = Utils.px2dip(this, offset) * 2; 

int alphaOut = (200 - alphaIn) < 0? 0 : 200 - alphalIn; 

/ 计算 淡 入 时 候 的 遮 音 透明 度 

int maskColorIn = Color.argb(alphalIn, Color.red(m MaskColor), 
Color.green(mMaskColor), Color.blue(mMaskColor)); 

/ 工具 栏 下 方 的 生活 频道 布局 要 加 速 淡 入 或 者 淡出 
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int maskColorInDouble = Color.argb(alphaln * 2, Color.red(mMaskColor), 
Color.green(mMaskColor), Color.blue(m MaskColor)); 

/ 计算 淡出 时 候 的 遮 单 透明 度 

int maskColorOut = Color.argb(alphaOut * 3, Colorred(mMaskColon)， 
Color.green(mMaskColor), Color.blue(mMaskColor)); 

让 (offset <= total * 0.45) { / 偏 移 量 小 于 一 半 ， 则 显示 伸展 时 候 的 工具 栏 


tl expand.setVisibility(View.VISIBLE); 
tl_collapse.setVisibility(View.GONE); 


V_expand mask.setBackgroundColor(maskColorInDouble); 


} else { // 偏 移 量 大 于 一 半 ， 则 显示 收缩 时 候 的 工具 栏 
tl expand.setVisibility(View.GONE); 
tlL_collapse.setVisibility(View.VISIBLE); 
V_collapse_mask.setBackgroundColor(maskColorOut); 


b 
/ 设置 it payxml 即 生活 频道 视图 的 遮 单 颜色 
V_pay_mask.setBackgroundColor(maskColorIn); 


7.7 ”实战 项 目 : 仿 淘宝 主页 


各 位 亲爱 的 读者 , 经 过 艰苦 的 App 开发 学 习 , 终于 来 到 了 
本 节 的 实战 项 目 “ 仿 淘宝 主页 ”。 淘 宝 App 的 主页 动感 十 足 ， 
页 面 元 素 丰 富 ， 令 人 了 眼花 练 乱 ， 其 中 运用 了 Android 的 多 种 终 
极 兵 器 ,可 谓 是 App 开发 UI 的 集大成 之 作 。 其 实 到 目前 为 止 ， 
本 章 的 知识 点 已 经 涵盖 了 淘宝 主页 的 大 部 分 技术 ， 所 以 仿照 淘 
宝 主页 做 一 个 山寨 的 电 商 App 首页 也 不 是 什么 难事 , 接 下 来 让 
我 们 好 好 分 析 一 下 如 何 实现 。 
7.7.1 设计 思 


首先 看 看 大 家 都 熟悉 的 淘宝 主页 长 什么 模样 ， 如 图 7-56 
所 示 。 是 不 是 很 熟悉 呢 ? 其 实 该 页 面 是 各 电 商 App 首页 的 通用 
模板 。 除 了 淘宝 外 ， 还 有 京东 、 苏 宁 易 购 、 当 当 、 美 团 、 饿 了 






多 用 因 


天 | 别 再 机 搭 了 | 你 的 外 套 就 应 该 配 这 . 
出 宝宝 出 生 后 ， 昨 报喜 ? 这 估计 是 最 





合 Gr 凤 已 Q 





7-56 淘宝 主页 截图 


么 等 ， 这 些 电 商 App 的 主页 都 大 同 小 异 ， 所 以 只 要 吃透 了 淘宝 主页 采用 的 App 技术 ， 其 他 电 


商 App 也 能 依 葫芦 画 闷 。 


因为 我 们 的 实战 项 目 只 是 仿 淘宝 主页 ， 而 不 是 完全 一 模 一 样 ， 所 以 页 面具 要 大 致 相似 就 
行 。 下 面 是 两 张 山寨 后 的 页 面 效 果 ， 图 7-57 所 示 为 首页 页 面 的 效果 图 ， 图 7-58 所 示 为 分 类 页 


面 的 效果 图 。 
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图 7-57 仿 淘宝 的 首页 页 面 图 7-58 仿 淘 宝 的 分 类 页 面 


考察 这 两 张 效 果 图 分 别 运 用 了 本 章 的 哪些 知识 点 。 这 两 个 页 面 基 本 上 是 由 前 面 介绍 的 各 
控件 效果 图 拼接 而 成 的 ， 找 起 来 也 不 难 。 


标签 栏 Tabbar: 页 面 底 部 有 一 排 标签 按钮。 
工具 栏 Toolbar: 页 面 顶部 的 导航 栏 是 工具 栏 Toolbar。 
溢出 菜单 OverflowMenu: 页 面 右上 角 的 三 点 按钮 是 标准 的 溢出 菜单 提示 。 
搜索 框 SearchView: 三 点 按钮 左边 的 放大 镜 按 钮 是 熟悉 的 搜索 图 标 。 
横幅 轮 播 Banner: 导航 栏 下 方 的 广告 图 片 底部 有 指示 器 ， 毫 无 疑问 是 Banner。 
循环 视图 RecyclerView 的 网 格 布局 : Banner 下 方 的 两 排 图 标 是 标准 的 网 格 布局 ， 再 下 面 
的 推荐 栏目 是 合并 网 格 后 的 网 格 布局 。 
标签 布局 TabLayout: 分 类 页 面 顶部 的 “服装 ”和 “电器 ”标签 用 到 了 标签 布局 。 
e 循环 视图 RecyclerView 的 瀑布 流 布局 : 电器 商品 的 交错 展示 运用 了 瀑布 流 网 格 布局 。 
另外 , 这 个 仿 淘 宝 主页 使 用 了 前 几 章 学 过 的 控件 , 包括 翻 页 视图 ViewPager、 碎 片 Fragment 
等 , 正好 一 起 复习 。 同 时, 购物 车 页 面 的 具体 处 理 已 经 体现 在 第 4 章 的 实战 项 目 中 了 ， 有 兴趣 
的 读者 可 以 将 其 整合 进来 ， 形 成 一 个 电 商 App 的 完整 demo。 


7.7.2 小 知识 : 下 拉 刷 新 布局 SwipeRefreshLayout 


电 商 App 在 商品 列表 页 面 往 往 提 供 下 拉 刷 新 功能 ， 把 页 面 整体 下 拉 即 可 触发 页 面 刷新 操 
作 。Android 提供 了 下 拉 刷 新 控件 SwipeRefreshLayout， 可 用 于 简单 的 下 拉 刷 新 。 
下 面 是 SwipeRefreshLayout 的 常用 方法 说 明 。 
esetOnRefieshListener: 设置 刷新 监听 器 。 需 要 重 写 监听 器 OnRefreshListener 的 onRefresh 
方法 ， 该 方法 在 下 拉 松 开 时 人 触发。 
e@ setRefreshing: 设置 刷新 的 状态 。true 表示 正在 刷新 ，false 表示 结束 刷新 。 
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isRefreshing: 判断 是 否 正在 刷新 。 

setColorSchemeColors: 设置 进度 圆圈 的 圆 环 颜色 。 
setProgressBackgroundColorSchemeColor: 设置 进度 圆圈 的 背景 颜色 。 
setProgressViewOffset: 设置 进度 圆圈 的 偏 移 量 。 第 一 个 参数 表示 进度 圈 是 否 缩放 ， 第 二 
个 参数 表示 进度 圈 开 始 出 现时 距 顶 端的 偏 移 ， 第 三 个 参数 表示 进度 圈 拉 到 最 大 时 距 顶 端 
的 偏 移 . 

e@ setDistanceToTriggerSync: 设置 手势 向 下 滑动 多 少 距 离 才 会 触发 刷新 操作 。 


需要 注意 的 是 ，SwipeRefreshLayout 节点 下 面 只 能 有 一 个 直接 子 视图 。 如 果 有 多 个 直接 子 
视图 , 那么 只 会 展示 第 一 个 子 视 图 , 后 面 的 子 视图 将 不 予 展 示 。 这 个 直接 子 视图 必须 允许 滚动 ， 
比如 ScrollView、ListView、GridView、RecyclerView 等 。 如 果 不 是 这 些 视图 ， 就 不 支持 滚动 ， 
更 不 支持 下 拉 刷 新 。 下 面 是 加 入 SwipeRefreshLayout 的 布局 文件 内 容 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout_width="match_parent" 





android:layout_height="match_parent" 
android:orientation="vertical" 
android:padding="5dp"> 


<!-- 注意 SwipeRefreshLayout 节点 必须 使 用 完整 路 径 --> 

<android.support.v4.widget.SwipeRefreshLayout 
android:id="(@+id/srl_simple" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<!-- SwipeRefreshLayout 的 下 级 必须 是 可 滚动 的 视图 -> 
<ScrollView 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<TextView 
android:id="@+id/tv_simple" 
android:layout_ width="match_parent" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:padding Top="10dp" 
android:text=" 这 是 一 个 简单 视图 " 
android:textColor="#000000" 
android:textSize="17sp" 亡 
</ScrollView> 
</android.support.v4.widget.SwipeRefreshLayout> 
</LinearLayout> 
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与 上 面 的 布局 文件 对 应 的 完整 页 面 代 码 如 下 : 


public class SwipeRefreshActivity extends AppCompatActivity implements OnRefreshListener { 
private TextView tv_simple; 
private SwipeRefreshLayout srl_simple; / 声明 一 个 下 拉 刷 新 布局 对 象 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_swipe_refresh); 
tv_simple = findViewById(R.id.tv_simple); 
// 从 布局 文件 中 获取 名 叫 srl_simple 的 下 拉 刷 新 布局 
srl_simple = findViewById(R.id.srl_simple); 
/ 给 stl_simple 设置 下 拉 刷 新 监听 器 
srl_simple.setOnRefreshListener(this); 
/ 设置 下 拉 刷 新 布局 的 进度 圆圈 颜色 
srl_simple.setColorSchemeResources( 
R.color.red, R.color.orange, R.color.green, R.color.blue); 
} 


/ 一 旦 在 下 拉 刷 新 布局 内 部 往 下 拉动 页 面 ， 就 触发 下 拉 监 听 器 的 onRefresh 方法 
public void onRefresh() { 

tv_simple setText(" 正 在 刷新 )); 

/ 延迟 若干 秒 后 启动 刷新 任务 

mHandler.postDelayed(mRefresh, 2000); 


) 


private Handler mHandler = new Handler0; / 声明 一 个 处 理 器 对 象 
/ 定义 一 个 刷新 任务 
private Runnable mRefresh = new Runnable() { 
@Override 
public void run() { 
tv_simple.setText(" 刷 新 完成 "); 
/ 结束 下 拉 刷 新 布局 的 刷新 动作 
SrL_simple.setRefreshing(false): 


} 
} 
这 个 简单 下 拉 刷 新 的 效果 如 图 7-59 和 图 7-60 所 示 。 其 中 ， 图 7-59 所 示 为 开始 刷新 时 的 
截图 ， 图 7-60 所 示 为 结束 刷新 时 的 截图 。 
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Group 


Group 


正 存 剧 新 刷新 完成 
2 


图 7-59 开始 刷新 时 的 截图 图 7-60 ”结束 刷新 时 的 截图 


SwipeRefreshLayout 更 好 的 用 法 是 与 RecyclerView 相 结合 , 通过 下 拉 刷 新 操作 动态 添加 循 
环视 图 的 记录 ， 从 而 省 去 一 个 添加 按钮 或 刷新 按钮 ， 就 优化 用 户 体验 来 说 ， 避 免 按钮 太 多 而 显 
得 凌乱 。 下 面 是 在 活动 页 面 中 结合 SwipeRefreshLayout 与 RecyclerView 的 代码 片段 : 

// 一 旦 在 下 拉 刷 新 布局 内 部 往 下 拉动 页 面 ， 就 触发 下 拉 监 听 器 的 onRefresh 方法 
public void onRefresh() { 


) 


/ 延迟 若干 秒 后 启动 刷新 任务 
mHandler.postDelayed(mRefresh, 2000); 


private Handler mHandler = new Handler(); / 声明 一 个 处 理 器 对 象 
/ 定义 一 个 刷新 任务 
private Runnable mRefresh = new Runnable() { 


上 


@Override 
public void run0) { 


/ 结束 下 拉 刷 新 布局 的 刷新 动作 

srl_dynamic.setRefreshing(false); 

int position = (int) (Math.random() * 100 % mAllArray.size()); 

GoodsInfo old_item = mAllArray.get(position); 

GoodsInfo new_item = new GoodsInfo(old_item.pic_id, 
old_item.title, old_item.desc); 

mpPublicArray.add(0, new_item); 

// 通知 适配器 列表 在 第 一 项 插入 数据 

mAdapter.notifyItemInserted(0); 

/ 让 循环 视图 滚动 到 第 一 项 所 在 的 位 置 


Tv_dynamic.scrollToPosition(0); 











对 循环 视图 进行 下 拉 刷 新 的 效果 如 图 7-61 和 图 7-62 所 示 。 其 中 ， 图 7-61 所 示 为 开始 刷 
新 时 的 列表 界面 ;图 7-62 所 示 为 结束 刷新 时 的 列表 界面 ， 此 时 列表 顶端 增加 了 一 条 新 记录 。 
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首都 日 报 


金秋 时 节 香 山 染 纪 





挨 踢 杂志 

市 让 ~、 分 登 山 赏 叶 米 6 大 战 Mate10 , 干 元 智能 机 谁 领 风 弘 
首都 日 报 

心 吴 二 金秋 时 节 香山 染 红 ,市民 纷纷 登山 赏 叶 


- 海峡 时 报 
上 ， 生 活 港 润 乐 不 思 允 © 台风 接 跨 而 来 ， 出 门 小 心 基 和 





北方 周末 
| 建成 通车 ， 中 国标 准 再 下 一 城 俄罗斯 老人 在 东北 ,生活 滋润 乐 不 思 驹 
挨 踢 杂志 参照 消息 
米 6 大 战 Mate10 ， 千 元 智能 机 谁 领 风 骚 成 通车 ,中国 标准 再 下 一 城 
挨 踢 杂志 
米 6 大 战 Mate10 ， 干 元 智能 机 谁 领 风 双 
图 7-61 刷新 中 的 消息 列表 图 7-62 刷新 完成 的 消息 列表 


7.7.3 ”代码 示例 
本 章 的 实战 项 目 用 到 了 TabLayout 与 RecyclerView， 因 为 这 两 个 控件 都 需要 导入 对 应 的 


库 


所 以 编码 过 程 与 前 两 章 相 比 多 了 一 步 ， 共 分 为 6 步 。 


人 ER) 设计 代码 架构 ， 初 步 拆 分 后 的 package 包 ， 包 括 以 下 6 部 分 。 


com.example.department.activity: 存放 Acitivity 页 面 的 代码 。 
com.example.department.adapter: 存放 适配器 的 代码 。 
com.example.department.bean: 存放 实体 数据 结构 的 代码 ， 如 商品 信息 。 
com.example.department.fragment: 存放 碎片 代码 。 
com.example.department.util: 存放 工具 类 代码 。 
com.example.department.widget: 存放 自 定义 控件 的 代码 。 


062 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 App 主页 面 的 代码 文件 取 名 
DepartmentStoreActivityjava， 对 应 的 布局 文件 名 是 activity_department_store.xml， 其 下 有 3 个 子 页 面 ， 

















包括 首页 页 面 的 代码 文件 取 名 DepartmentHomeActivityjava ， 对 应 的 布局 文件 名 是 
activity_department_home.xml; 分 类 页 面 的 代码 文件 取 名 DepartmentClassActivityjava， 对 应 的 布局 文 
件 名 是 activity_department_class.xml; 购物 车 页 面 的 代码 文件 取 名 DepartmentCartActivityjava, 对 应 的 
布局 文件 名 是 activity_department_cart.xml。 

除 此 之 外 , 还 有 搜索 页 面 SearchViewActivity、 搜 索 结果 页 面 SearchResultActvity 以 及 碎片 、 适 配 
器 的 代码 及 其 布局 文件 ， 读 者 可 自行 构思 。 


ET3 打 天 


F build.gradle ， 在 dependencies 节点 中 加 入 下 面 3 行 代码 ， 表 示 分 别 导 入 





appcompat-v7、design、recyclerview-v7 三 个 库 : 


implementation 'com.android.support:appcompat-v7:28.0.0" 
implementation 'com.android.support:design:28.0.0” 
implementation 'com.android.support:recyclerview-v7:28.0.0" 
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(1) 注册 五 个 页 面 的 acitivity 节点 ， 注 册 代码 如 下 : 











<activity android:name=".DepartmentStoreActivity" android:theme="(@style/AppCompatTheme" /> 
<activity android:name=".DepartmentHomeActivity" android:theme="(@style/AppCompatTheme" /> 
<activity android:name=".DepartmentClassActivity" android:theme="(@style/AppCompatTheme" /> 
<activity android:name=".DepartmentCartActivity" android:theme="(@style/AppCompatTheme" /> 
<activity android:name=".SearchViewActivity" android:theme="(@style/AppCompatTheme" /> 


(2) 对 SearchResultActvity 单独 配置 ， 注 册 代 码 举 例如 下 : 


<activity android:name=".SearchResultActvity" android:theme="(@style/AppCompatTheme" > 
<intent-filter> 
<action android:name="android.intent.action.SEARCH"/> 
</intent-filter> 
<meta-data android:name="android.app.searchable" android:resource="(@xml/searchable"/> 
</activity> 
注意 这 里 给 activity 节点 补充 了 AppCompatTheme 风格 ， 目 的 是 声明 不 带 ActionBar 的 风格 ， 以 
便 Activity 代码 内 部 使 用 Toolbar 替换 ActionBar。 























(1) 在 res/drawable 目录 下 存放 相关 状态 图 形 的 描述 文件 。 

(2) 在 res/layout 目录 下 编写 页 面 、 碎 片 、 适 配器 、 标 签 页 等 对 应 的 布局 文件 。 

(3) 在 res/menu 目录 下 编写 溢出 菜单 的 布局 文件 。 

(4) 在 res/values/styles.xml 中 补充 AppCompatTheme 与 标签 按钮 的 样式 定义 。 

(5) 在 res/xml 目录 下 创建 searchable.xml， 编 写 根 节点 为 searchable 的 搜索 框 样式 定义 。 


G06 进行 java 代码 开发 ， 包 括 对 页 面 、 碎 片 、 适 配器 等 进行 编码 。 


下 面 简单 介绍 一 下 本 书 附带 源码 group 模块 中 ， 与 仿 电 商 App 首页 有 关 的 主要 代码 之 间 
的 关系 。 

(1) DepartmentStoreActivity.java: 这 是 仿 电 商 App 首页 的 入 口 代码 , 采用 ActivityGroup 
方式 的 底部 标签 栏 ， 挂 载 了 “首页 ”、“ 分 类 ”和 “购物 车 ”三 个 标签 及 其 对 应 的 三 个 活动 页 
面 。 

(2) DepartmentHomeActivity.java: 这 是 “首页 ”标签 对 应 的 活动 页 面 代码 ， 从 上 到 下 依 
次 分 布 着 工具 栏 、 广 告 轮 播 条 、 市 场 网 格 列表 、 猜 你 喜欢 的 合并 网 格 列表 , 主要 运用 了 Toolbar、 
BannerPager、RecyclerView 等 组 合 控件 。 

(3) DepartmentClassActivity.java: 这 是 “分 类 ”标签 对 应 的 活动 页 面 代码 ， 该 页 面 顶端 
的 工具 栏 通过 集成 标签 布局 TabLayout， 又 加 载 了 服装 与 电器 两 个 瀑布 流 列表 碎片 ， 从 而 形成 
ActivityGroup 一 Activity 一 Fragment 的 多 重 嵌 套 页 面 结构 。 

(4) DepartmentCartActivityjava: 这 是 “购物 车 ”标签 对 应 的 活动 页 面 代 码 ， 有 具体 实现 
可 参考 第 4 章 的 实战 项 目 “ 购 物 车 ”。 

(5) SearchViewActivity.java: 点 击 首页 右上 角 的 刷新 图 标 ， 就 跳 转 到 专门 的 搜索 页 面 
SearchViewActivity， 在 搜索 页 面 上 方 的 搜索 框 中 ， 可 输入 关键 词 进行 搜索 操作 。 
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(6) SearchResultActvity.java: 点 击 搜索 页 面 搜索 框 右边 的 箭头 按钮 ， 立 刻 携 带 搜 索 关 键 
字 跳 转 到 搜索 结果 页 面 ， 在 此 执行 具体 的 搜索 逻辑 ， 并 展示 相应 的 查询 结果 。 


7.8 小 结 


本 章 主 要 介绍 了 App 开发 的 组 合 控件 相关 知识 , 包括 标签 栏 的 用 法 (标签 按钮 、3 种 标签 
栏 的 实现 方式 ) 、 导 航 栏 的 用 法 〈 工 具 栏 、 溢 出 菜单 、 搜 索 框 、 标 签 布局 ) 、 横 幅 条 的 用 法 〈 自 
定义 指示 器 、 横 幅 轮 播 Banner 的 实现 ) 、 增 强 型 列表 的 用 法 〈 循 环视 图 、3 种 布局 管理 器 、 
动态 变更 循环 视图 ) 、 材 质 设计 库 常 见 的 3 种 布局 用 法 (协调 布局 、 应 用 栏 布局 、 可 折合 工具 
栏 布局 ) 。 最 后 设计 了 两 个 实战 项 目 ， 一 个 是 “ 仿 支付 宝 的 头 部 伸缩 特效 ”， 另 一 个 是 “ 仿 淘 
宝 主 页 ”。 在 “ 仿 支付 宝 的 头 部 伸缩 特效 ”的 项 目 编码 中 ， 联 合 运 用 了 前 面 介 绍 的 部 分 组 合 控 
件 。 在 “ 仿 淘 宝 主页 ”的 项 目 编码 中 ， 采 用 了 本 章 介绍 的 大 部 分 组 合 控件 知识 ， 并 复习 了 前 几 
章 的 相关 技术 。 另 外 ， 介 绍 了 如 何 使 用 下 拉 刷 新 控件 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 5 种 开发 技能 : 

(1) 学 会 底部 标签 栏 的 实现 与 用 法 。 

(2) 学 会 顶部 导航 栏 的 实现 与 用 法 。 

(3) 学 会 横幅 轮 播 Banner 的 实现 与 用 法 。 

(4) 学 会 循环 视图 及 其 3 种 布局 管理 器 的 用 法 ， 以 及 通过 下 拉 刷 新 控件 动态 更 新 视图 记录 。 

(5) 学 会 材质 设计 库 主 要 的 三 种 布局 用 法 。 


调试 与 上 线 


本 章 介 绍 App 从 调试 到 上 线 的 完整 过 程 ， 主 要 包括 利用 模拟 器 和 真 机 调试 App、App 在 
上 线 前 的 各 种 准备 工作 、 对 App 安装 包 进 行 安全 加 固 、 把 App 发 布 到 应 用 商店 的 具体 步骤 等 。 


8.1 调试 工作 


本 节 介 绍 几 种 常见 的 App 调试 方法 ， 包 括 使 用 外 置 模拟 器 调试 ， 比 如 几 种 国产 模拟 器 的 
用 法 ; 电脑 连接 真 机 调试 ， 描 述 真 机 调试 要 具备 的 条 件 ; 分 发 APK 安装 包 给 他 人 调试 ， 着 重 
说 明 签 名 证 书 的 创建 方法 ， 以 及 如 何 利用 签名 证 书 导 出 APK 安装 包 。 


8.1.1 模拟 器 调试 

前 面 几 章 的 App 开发 学 习 基 本 采用 了 模拟 器 进行 功能 测试 与 效果 演示 。 在 模拟 器 的 使 用 
过 程 中 ， 不 知道 读者 有 没有 发 现 Android Studio 自 带 的 模拟 器 存在 诸多 不 便 ， 比 如 : 

(1) 内 置 模拟 器 启动 速度 慢 ， 资 源 占用 大 。 

(2) 单个 模拟 器 的 屏幕 分 辩 率 是 固定 的 ， 若 要 测试 不 同 分 辩 率 ,只 能 另外 创建 新 模拟 器 。 

(3) 内 置 模拟 器 默认 是 竖 屏 显示 ， 无 法 测试 横 屏 的 显示 效果 。 

(4) 内 置 模拟 器 不 支持 设置 手机 信息 ， 如 手机 品牌 、 型 号 、IMEI 等 。 

(5) 内 置 模拟 器 不 支持 模拟 传感器 功能 ， 如 摇 一 摇 等 ， 也 不 支持 模拟 定位 。 


从 上 面 可 以 看 出 ， 内 署 模拟 器 用 于 简单 App 的 测试 还 凑合 ， 如 果 用 于 高 级 测试 场景 就 无 
法 胜任 。 为 了 方便 广大 App 开发 者 ， 各 种 外 置 的 安 卓 模拟 器 如 雨后春笋 般 涌现 出 来 ， 比 如 国 
外 的 Genymotion 模拟 器 、 各 种 国产 模拟 器 。 这 里 笔者 介绍 三 款 用 得 比较 多 的 国产 模拟 器 一 一 
道 遥 安 卓 模拟 器 、 夜 神 模 拟 器 和 雷电 模拟 器 。 
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1. 遂 遥 安 卓 模拟 器 


道 遥 安 卓 模拟 器 基于 Android 4.2.2 (SDK 版 本 19)， 官方 网 站 地 址 是 http://www.xyaz.cn/。 
从 官方 网 站 下 载 安装 文件 ， 下 载 完 成 后 双击 即 可 弹出 安装 界面 ， 如 图 8-1 所 示 。 


下 





图 8-1 道 遥 安 卓 的 安装 界面 


选择 模拟 器 的 安装 目录 路 径 ， 然 后 单 击 “ 安 装 ”按钮 ， 等 待 安装 过 程 。 安 装 结束 后 ， 桌 
面 会 出 现 名 为 “ 道 遥 安 卓 ” 的 图 标 ， 双 击 该 图 标 打开 模拟 器 ， 模 拟 器 的 启动 需要 一 定时 间 〈 可 
能 需 几 十 秒 ) 。 耐 心 等 待 模拟 器 启动 完毕 ， 界 面 切换 到 模拟 器 的 仿 手机 主页 ， 如 图 8-2 所 示 。 





图 8-2 道 遥 安 卓 的 横 屏 桌面 


道 遥 安 卓 默 认 展 示 横 屏 ， 若 想 切换 到 竖 屏 显示 ， 则 单 击 模拟 器 主 界面 右 侧 一 列 图 标的 第 5 
个 或 第 6 个 “旋转 屏幕 ”图 标 ， 即 可 进行 横竖 屏 切换 ， 切 换 后 的 竖 屏 界面 如 图 8-3 所 示 。 

右 侧 图 标 列 除了 “旋转 屏幕 ”外 ， 还 有 截图 、 摇 一 摇 、 屏 幕 录制 、 设 置 〈 齿 轮 图 标 ) 、 
音量 控制 等 图 标 。 单 击 齿轮 图 标 打开 设置 窗口 ， 在 “常用 ”页 面 可 设置 CPU 个 数 、 内 存 大 小 、 
分 辩 率 等 信息 ， 在 “高 级 ”页 面 可 设置 手机 品牌 、 手 机 型 号 、IMEI 串 号 等 信息 ， 如 图 8-4 所 
示 。 设 置 修改 完毕 后 ， 单 击 窗口 下 方 的 “保存 ”按钮 ， 新 设置 在 下 次 启动 模拟 器 后 生效 。 

遂 遥 安 卓 主 界面 右 下 角 还 有 一 列 〈 共 4 个 图 标 ) ， 从 上 往 下 依次 表示 后 退 键 、 桌 面 键 、 
任务 键 、 菜 单 键 。 多 数 手机 的 下 方 只 有 3 个 按键 ， 从 左 往 右 分别 是 菜单 键 、 桌 面 键 、 后 退 键 ， 
长 按 桌 面 键 会 弹出 任务 列表 〈 近 期 有 运行 的 App 列表 ) ， 有 的 手机 取消 菜单 键 换 成 任务 键 ， 
遂 遥 安 卓 提供 4 个 按钮 模拟 这 4 种 按键 操作 。 
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[iss =) HUAWE Mate9 Pro - 


133524680875430 生成 | 


FSM(China Mobile GSM) 到 











ER = 
四 TIRE | 
回 旦 示 安 点 是 示 加 
回 对 间 同 步 百 
| 

8-3 ” 遂 遥 安 卓 的 竖 屏 桌面 道 遥 安 卓 的 设置 界面 


利用 遂 遥 安 卓 调 试 App 的 过 程 与 内 置 模拟 器 类 似 ， 开 发 者 先 启动 Android Studio， 等 待 启 
动 完 成 后 再 双击 启动 省 遥 安 卓 。 等 待 道 遥 安 卓 启动 完成 进入 桌面 后 ， 在 Android Studio 上 依次 
选择 菜单 Run 一 Run ***， 这 时 弹出 设备 选择 窗口 ， 如 图 8-5 所 示 。 





® Select Deployment Target = > 











Connected Devices 


国 Huavei LON-ALOO (Android 


Create New Virtual Device | 














8-5 ”启动 App 时 发 现 道 遥 安 卓 模拟 器 


该 窗口 中 的 Huawei LON-AL00 (Android 4.2.2, API 17) 为 省 遥 安 卓 模拟 器 ， 单 击 窗口 下 
方 的 OK 按钮 ， 等 待 Android Studio 编译 并 将 App 安装 到 遂 遥 安 卓 ， 后 续 的 App 调试 操作 就 
可 以 在 模拟 器 上 执行 了 。 


2. 夜 神 模拟 器 


夜 神 模拟 器 基于 Android 4.4.2 (SDK 版 本 17)， 官方 网 站 地 址 是 http://www.yeshen.com/。 
从 官方 网 站 下 载 安装 文件 ， 下 载 完成 后 双击 打开 ， 弹 出 安装 界面 如 图 8-6 所 示 。 

单 击 “快速 安装 ”按钮 或 右 下 角 的 “ 自 定义 安装 ”设置 安装 路 径 ， 然 后 等 待 安装 过 程 。 
安装 结束 后 ， 桌 面 会 出 现 名 为 “ 夜 神 模拟 器 ”的 图 标 ， 双 击 该 图 标 打开 模拟 器 ， 模 拟 器 的 启动 
需要 一 定时 间 。 耐 心 等 待 模拟 器 启动 完毕 ， 界 面 切换 到 模拟 器 的 仿 手机 主页 ， 如 图 8-7 所 示 。 
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图 8-6 夜 神 模拟 器 的 安装 界面 图 8-7 夜 神 模拟 器 的 横 屏 桌面 


夜 神 默认 展示 竖 屏 还 是 横 屏 与 设置 有 关 ， 在 界面 右上 角 的 中 央 找 到 一 个 齿轮 图 标 ， 这 是 
模拟 器 的 设置 入 口 ， 单 击 该 图 标 弹出 设置 窗口 ， 如 图 8-8 所 示 。 





图 8-8 夜 神 模拟 器 的 设置 界面 


在 设置 窗口 的 左边 菜单 列表 中 单 击 “高 级 菜单 ”选项 ， 窗 口 右 边 就 切换 到 高 级 设置 页 面 。 
这 里 可 以 设置 模拟 的 CPU 个 数 、 内 存 大 小 ， 还 可 设置 默认 显示 横 屏 〈 平 板 版 ) 还 是 竖 屏 ( 手 
机 版 ) ， 以 及 模拟 界面 的 屏幕 分 辩 率 。 设 置 修改 完成 后 ， 单 击 窗口 下 方 的 “保存 设置 ”按钮 ， 
下 次 启动 模拟 器 时 就 会 生效 最 新 的 设置 。 

夜 神 模拟 器 主 界面 右边 是 一 列 图 标 按钮 ， 用 于 一 些 特 殊 功能 的 快捷 操作 ， 包 括 摇 一 摇 、 
屏幕 截图 、 虚 拟定 位 、 音 量 控制 、 视 频 录 制 等 ， 开 发 者 可 在 具体 的 功能 测试 时 加 以 控制 。 主 界 
面 右 下 角 有 3 个 控制 图 标 ， 从 上 往 下 依次 表示 返回 键 、 主 页 键 、 任 务 键 〈 提 示 菜 单 键 ， 其 实 是 
任务 键 ) 。 这 里 找 不 到 可 用 的 菜单 键 是 不 是 很 奇怪 ? 其 实 夜 神 模 拟 器 的 菜单 键 需 要 电脑 键盘 输 
入 ， 电 脑 键盘 右 下 方 的 Alt 键 与 Ctrl 键 之 间 有 一 个 “一 口 三 横 ” 键 (菜单 键 ) ， 按 电脑 键盘 的 
菜单 键 相 当 于 模拟 器 的 菜单 键 点 击 操作 。 

利用 夜 神 模 拟 器 调试 App 的 过 程 与 道 遥 安 卓 类 似 ， 开 发 者 先 启动 Android Studio， 再 启动 
夜 神 模拟 器 ， 等 待 夜 神 启动 完毕 进入 桌面 后 ， 回 到 Android Studio 选择 菜单 Run 一 Run ***'。 
此 时 弹出 的 设备 选择 窗口 如 图 8-9 所 示 。 
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® Select Deployment Tarset = 





Connected Devices 


@ Sansung Nexus 


Create New Virtual Device 
| " je 


图 8-9 启动 App 时 发 现 夜 神 模拟 器 








该 窗口 中 的 Samsung Nexus (Android 4.4.2, API 19) 为 夜 神 模 拟 器 ， 单 击 窗口 下 方 的 OK 
按钮 ， 等 待 Android Studio 将 App 安装 到 夜 神 ， 后 续 即 可 在 模拟 器 上 调试 。 


3. 雷电 模拟 器 


雷电 模拟 器 基于 Android 5.1.1 (SDK 版 本 22) ， 它 的 官网 地 址 是 http://www.ldmnq.com/。 
从 官网 上 下 载 安装 文件 ， 一 路 安装 完毕 然后 启动 ， 可 见 如 图 8-10 所 示 的 模拟 器 仿 手机 桌面 。 





图 8-10 雷电 模拟 器 的 横 屏 桌面 


在 桌面 右 侧 的 列表 中 找到 “设置 ”按钮 ， 点 击 它 打 开 模 拟 器 的 设置 页 面 ， 如 图 8-11 所 示 。 





自动 族 转 羽衣 


屋宇 窑 口 大 小 


root 到 限 


图 8-11 雷电 模拟 器 的 设置 界面 
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像 手机 的 横 屏 / 竖 屏 方式 ， 以 及 分 辨 率 大 小 ， 都 能 在 设置 页 面 的 “高 级 设置 ”菜单 下 进行 
修改 。 回 到 模拟 器 主 界面 ， 在 右 下 方 找到 一 排 三 个 按钮 ， 从 上 到 下 依次 模拟 手机 的 返回 键 、 主 
页 键 和 任务 键 。 

利用 雷电 模拟 器 调试 App 的 过 程 与 前 面 两 个 模拟 器 类 似 ， 也 是 先 启 动 Android Studio， 再 
启动 雷电 模拟 器 。 等 待 雷电 启动 完毕 进入 桌面 后 ， 回 到 Android Studio 选择 菜单 “Run ”一 一 
“Run ***#*”， 此 时 弹出 的 设备 选择 窗口 如 图 8-12 所 示 。 


MW Select Deployment Target 











Comnected Devices 
国 


国 127- 0.0.1:5555 [OFFLINE] 


Create Nev Yirtual Device | 
[" [En [ao 








图 8-12 启动 App 时 发 现 雷电 模拟 器 
该 窗口 中 的 “Xiaomi Mi-4c (Android 5.1.1, API 22) ” 即 为 雷电 模拟 器 ， 单 击 窗口 下 方 的 
“OK” 按 钮 ， 等 待 Android Studio 将 App 安装 到 雷电 ， 后 续 即 可 在 模拟 器 上 调试 。 
8.1.2 真 机 调试 
外 置 横 拟 器 即使 做 得 再 好 ， 对 很 多 功能 的 调试 也 力 有 不 过， 毕竟 没 法 完全 模拟 真实 手机 ， 
若 有 可 能 ， 还 是 尽量 使 用 真 机 进行 测试 。 利 用 真 机 调试 要 具备 以 下 4 个 条 件 : 
1. 需要 使 用 数据 线 把 手机 连 到 电脑 上 。 


手机 的 电源 线 拔 掉 插 头 就 是 数据 线 。 数 据 线 长 方形 的 一 端 接 到 电脑 的 USB 口上 ， 即 可 完 
成 手机 与 电脑 的 连接 。 


2. 要 在 电脑 上 安装 手机 的 驱动 程序 。 


- 般 电 脑 会 把 手机 当 作 USB 存储 设备 一 样 安装 驱动 ， 大 多 数 情 况 会 自动 安装 成 功 。 如 果 
遇 到 少数 情况 安装 失败 ， 就 可 以 先 安装 91 手机 助手 ， 自 动 下 载 并 安装 对 应 的 手机 驱动 。 


3. 要 在 手机 上 启用 USB 调试 功能 。 


手机 连接 电脑 后 ， 下 拉 通 知 栏 会 有 “USB 计算 机 连接 ”选项 ， 点 击 该 选项 跳 到 USB 连接 
页 面 。 勾 选 页 面 上 的 “USB 调试 ”选项 开启 USB 调试 功能 ， 如 图 8-13 所 示 。 调试 功能 开启 后 ， 
首次 拿手 机 连接 电脑 ， 屏 幕 上 都 会 弹 窗 “允许 USB 调试 吗 ?””， 如 图 8-14 所 示 。 色 选 弹 窗 的 
“一 律 允许 这 台 计 算 机 进行 调试 ”， 然 后 点 击 “ 确 定 ” 按 钮 ， 该 手机 就 可 以 调试 App 了 。 

USB 调试 功能 可 在 设置 中 通过 “系统 ”一 “开发 者 选项 ” (有 的 手机 在 “系统 ”一 “更 
多 设置 ”一 “开发 者 选项 ”) 找到 ， 勾 选 该 功能 开启 USB 调试 ， 如 图 8-15 所 示 。 
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《USB 计算 机 连接 

















这 允许 USB 调试 吗 ? 
这 台 计 算 机 的 RSA 密 钥 指纹 如 下 : 
96:6B:73:33:C3:A9:F1:6D:D1:4A:0D: 
相机 (PTP) 69:9A:8F:B4:DE 
这 这 计 司机 丛生 加 | 
US8 存 哺 设 和 Ge 革 We 口 @ 一 厘 区 许 使 用 这 台 计算 机 进行 调 斌 
Fy 
6 而 
USB 调试 
连接 US6 后 启用 调试 硕 式 
8-13 ”USB 计算 机 连接 页 面 图 8-14 ”USB 调试 的 提示 对 话 框 




















8-15 开发 者 选项 页 面 


现在 很 多 手机 默认 没有 “开发 者 选项 ”这 个 菜单 ， 即 使 把 手机 连接 到 电脑 ， 仍 然 无 法 找 
到 “开发 者 选项 ”， 更 别提 USB 调试 了 。 此 时 要 进入 “系统 ”一 “关于 手机 ”一 “版 本 信息 ” 
页 面 , 这 里 有 好 几 个 版 本 项 , 每 个 版 本 项 都 使 劲 点 击 七 、 八 下 , 总 会 有 某 个 版 本 点 击 后 出 现 “ 你 
将 开启 开发 者 模式 ”的 提示 。 继续 点 击 该 版 本 项 开启 开发 者 模式 , 然后 退出 并 重新 进入 设置 页 
面 ， 此 时 就 能 在 “系统 ”菜单 下 找到 “开发 者 选项 ”了 。 

4. 手机 要 处 于 使 用 状态 ， 即 不 能 锁 屏 。 

锁 屏 状态 下 ，Android Studio 向 手机 安装 App 的 行为 会 被 拦截 ， 所 以 要 保证 手机 处 于 解锁 
状态 ， 才 能 顺利 通过 开发 电脑 安装 App 到 手机 上 。 

经 过 以 上 步骤 , 总 算 具 备 通过 电脑 在 手机 上 安装 App 的 条 件 了 。 马上 启动 Android Studio， 
依次 选择 菜单 Run 一 Run '***",， 在 弹出 的 设备 选择 窗口 可 以 看 到 已 连接 的 手机 信息 ， 如 图 8-16 
所 示 。 此 时 的 设备 信息 提示 这 是 一 台 小 米 手 机 , 单 击 窗口 下 方 的 OK 按钮 ， 接 下 来 的 事情 就 是 
等 待 Android Studio 往 手机 上 安装 App 了 。 


两 Select Deployment 


Create Her Virtual Device | 
3 ence [sep | 











图 8-16 启动 App 时 发 现 真实 的 手机 
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8.1.3 导出 APK 安装 包 


前 面 讲 的 真 机 调试 是 通过 数据 线 把 手机 连 到 电脑 上 ， 不 过 在 公司 的 App 开发 工作 中 ,一 
个 App 要 在 多 部 测试 手机 上 安装 ， 难 道 每 次 都 得 把 手机 拿 到 手 才 能 安装 App 吗 ? 这 么 做 显然 
很 不 方便 ,此 时 可 以 把 App 打包 成 一 个 APK 文件 (该 文件 就 是 App 的 安装 包 )， 然 后 把 APK 
传 给 测试 人 员 进 行 后 续 调试 工作 。 在 Android Studio 中 打包 APK， 具 体 步骤 如 下 : 


CT01 依次 选择 菜单 Build 一 Generate Signed Bundle / APK...， 弹 出 窗口 如 图 8-17 所 示 。 
E302 在 该 窗口 中 选择 左下 方 的 APK 选项 ， 单 击 Next 按钮 ， 进 入 APK 签名 窗口 页 面 ， 如 图 
8-18 所 示 。 
一 cncrate Simncd RE Cr AFL 


OAndrotd App Bundle 



































Greate ner | | Choose extstlng 








Ar 

| Bes shone as tat mu sm deley to » derles a 

| Ce ee Eels Bevios | cancer lelp 
图 8-17 生成 安装 包 的 窗口 页 面 图 8-18 APK 签名 的 窗口 页 面 


CBT03 在 该 窗口 选择 待 打 包 的 模块 名 (如 test) ， 以 及 密 钥 文件 的 路 径 ， 如 果 原 来 有 密 钥 文件 ， 
就 单 击 Choose existing.… 按 钮 ， 在 弹出 的 文件 对 话 框 中 选择 密 钥 文件 。 如 果 第 一 次 打包 没有 密 钥 文件 ， 
就 单 击 Create new... 按 钮 ， 然 后 弹出 一 个 密 钥 创 建 窗口 ， 如 图 8-19 所 示 。 

CI04 单 击 该 窗口 右上 角 的 四 按钮 ， 选 择 密 钥 文件 的 保存 路 径 ， 单 击 按钮 后 弹出 文件 对 话 框 ， 
如 图 8-20 所 示 。 




















Ee 
Save as sg 
一 一 p | | 
Nev Key St mr = |#59mmxg Hide path 
key store path: [| ]L-] F:\studioprolects\HelloVerid\test 妆 
re 
Password: Confira: | Dienororld 
» .ede 
key 











Alias: 





Passvord: | gontim: | 
Talidity ears): [| 725 

-certificate 
Elrst and Last Nane: 

















Organizational Unit: | 








Organization: 








City or Locality: l 








State or Province: 








Country Code (IX): 












































WE [ee 





图 8-19 ” 密 钥 文件 的 生成 窗口 8-20” 密 钥 文件 的 文件 对 话 框 
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人 5 在 文件 对 话 框 中 选择 文件 保存 路 径 ， 并 在 下 方 File name 右边 输入 密 钥 文件 的 名 称 ， 然 
后 单 击 OK 按钮 回 到 密 钥 创 建 窗口 。 在 该 窗口 依次 填写 密码 Password、 确认 密码 Confirm、 别名 Alias、 
别名 密码 Password、 别 名 的 确认 密码 Confirm， 修 改 密 钥 文件 的 有 效 期 限 Validity。 下 面 的 输入 框 只 
姓名 (First and Last Name) 是 必 填 的 ， 填 完 后 的 窗口 如 图 8-21 所 示 。 

G06 单 击 OK 按钮 回 到 APK 签名 窗口 ， 此 时 Android Studio 自动 把 密码 和 别名 都 十 上 了 ， 
如 图 8-22 所 示 。 如 果 一 开始 选择 已 存在 的 密 钥 文件 ， 这 里 就 要 手工 输入 密码 和 别名 。 
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图 8-21 填写 完成 的 密 钥 创 建 窗口 图 8-22 填 上 签名 信息 的 签名 窗口 


CI07 单 击 Next 按钮 进入 下 一 个 页 面 ， 如 果 是 启动 后 第 一 次 打包 ， 就 会 弹出 管理 员 密 码 确认 
窗口 ， 如 图 8-23 所 示 。 输 入 密码 再 单 击 OK 按钮 进入 APK 保存 页 面 ， 如 图 8-24 所 示 。 如 果 不 是 第 一 
次 打包 ， 就 直接 进入 APK 保存 页 面 。 


Enter Msrer Pes snord 0 — TEFS 加 
| 6 CE Bad yee EEE 














Naster password ia reqsred to vnlock the passyord databese. 
The possword database will be unlocked ducing this sessicn ee 
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图 8-23 管理 员 密 码 确认 窗口 图 8-24 APK 保存 页 面 


APK 保存 页 面 可 选择 APK 文件 的 保存 路 径 ， 并 下 拉 选 择 编译 类 型 (Build Type) ， 如 果 
是 调试 用 ， 则 编译 类 型 选择 debug; 如 果 是 发 布 用 ， 则 编译 类 型 选择 release。 注 意 到 下 面 还 有 
V1 和 V2 两 个 复 选 框 ， 其 中 V1 是 必须 勾 选 的 ， 否 则 打出 来 的 APK 文件 无 法 正常 安装 ，V2 
建议 也 勾 选 ， 该 选项 可 避免 Janus 漏洞 。 如 果 后 续 想 成 功 上 架 到 各 大 应 用 商店 ， 就 要 同时 色 选 
V1 和 V2， 因 为 现在 很 多 应 用 商店 为 了 规避 Janus 漏洞 ， 都 要 求 开发 者 必须 勾 选 V2 选项 。 最 
后 单 击 “Finish” 按 钮 ， 等 待 Android Studio 生成 APK 安装 包 。 

若 无 编译 问题 ， 过 一 会 儿 即 可 在 APK 保存 路 径 下 看 到 名 为 “test-release.apk” 的 文件 。 把 
该 安装 包 传 给 其 他 人 ， 对 方 用 数据 线 把 APK 文件 复制 到 自己 手机 的 SD 卡 上 ， 然 后 打开 手机 
上 的 文件 管理 器 ， 找 到 这 个 安装 包 即 可 点 击 进行 安装 。 
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如 果 APK 文件 安装 失败 ， 则 可 能 是 以 下 原因 导致 的 : 


(1) 在 导出 APK 安装 包 时 ， 未 勾 选 V1 选项 ， 会 导致 安装 时 提示 解析 失败 。 

(2) App 只 能 升级 不 能 降级 ,假如 安装 包 的 版 本 号 小 于 已 安装 App 的 版 本 号 ， 也 无 法 正 
常安 装 。 版 本 号 在 模块 编译 文件 build.gradle 中 的 versionCode 节点 配置 。 

(3) 倘若 新 旧 App 的 签名 不 一 致 ， 也 会 安装 失败 。 比 如 该 手机 之 前 安装 了 debug 类 型 的 
App, 现在 又 要 安装 release 类 型 的 版 本 ， 就 会 出 现 签 名 冲突 。 有 时 候 开 发 者 觉得 明明 已 经 卸载 
干净 了 , 为 啥 还 是 报 签名 冲突 ? 此 时 还 要 检查 一 下 手机 是 否 提供 分 身 功 能 , 像 小 米 手机 自 带 分 
身 功能 ， 造 成 另 一 个 分 身 还 存在 该 App。 


8.2 准备 上 线 


本 节 介 绍 App 上 线 前 必须 做 的 准备 工作 ， 包 括 正确 设置 版 本 信息 ， 例 如 设置 App 图 标 、App 
名 称 、App 版 本 号 ; 把 开发 模式 切换 到 上 线 模式 , 除了 代码 的 切换 外 , 还 需 修改 AndroidManifestxml; 
对 关键 业务 数据 进行 加 密 处 理 ， 加 密 算法 主要 有 MD5、RSA、AES、3DES、SM3 等 。 


8.2.1 版 本 设置 


迄今 为 止 , 本 书 所 有 演示 App 在 屏幕 上 都 显示 默认 的 机 器 人 图 标 , 不 过 推出 一 个 正式 App 
需要 用 自己 设计 的 图 标 ， 而 且 App 名 称 要 把 英文 名 换 成 中 文 名 。App 安装 后 需要 经 常 升级 ， 
所 以 少不了 版 本 号 的 管理 。 开 发 一 个 正式 App 需要 定制 3 类 版 本 信息 , 分 别 是 App 图 标 、App 
名 称 和 App 版 本 号 。 


1.App 图 标 


App 图 标 文件 是 res/mipmap-*** 目 录 下 的 ic_launcher.png。 若 要 更 改 手机 桌面 上 的 应 用 图 
标 ， 则 要 把 mipmap-*** 目 录 下 的 ic_launcher.png 换 成 新 图 标 。 


2.App 名 称 


App 名 称 保存 在 res/values/strings.xml 的 app_name 中 。 若 要 更 改 手机 桌面 上 的 应 用 名 称 ， 
则 要 把 strings.xml 的 app_name 改 成 新 名 称 。 


3.App 版 本 号 

App 版 本 号 放 在 build.gradle 的 versionCode 与 versionName 两 个 参数 中 。versionCode 必须 
为 整 型 值 ， 每 次 升级 版 本 时 值 都 要 加 1。versionName 形 如 “数字 .数字 .数字 ”， 第 一 个 数字 为 
大 版 本 号 ， 有 重要 功能 升级 时 ， 大 版 本 号 要 加 1， 后 面 两 个 数字 清 零 ; 第 二 个 数字 为 中 版 本 号 ， 
每 次 要 进行 功能 更 新 时 ， 中 版 本 号 加 1， 第 三 个 数字 清 零 ; 第 三 个 数字 为 小 版 本 号 ， 在 有 问题 
修复 与 界面 微调 时 ， 小 版 本 号 加 1。 

注意 每 次 App 升级 ，versionCode 与 versionName 都 要 一 起 更 改 ， 不 能 只 改 其 中 一 个 。 升 
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级 后 的 versionCode 与 versionName 只 能 比 原来 大 ， 不 能 比 原来 小 。 如 果 没 有 按照 规范 修改 版 
本 号 ， 就 会 产生 以 下 问题 : 


(1) 版 本 号 比 已 安装 的 版 本 号 小 ， 在 安装 时 直接 提示 失败 ， 因 为 App 只 能 做 升级 操作 ， 
不 能 做 降级 操作 。 

(2) 更 新 系统 内 置 应 用 时 ， 如 果 只 修改 versionName， 没 修改 versionCode， 重 启 手机 后 
就 会 发 现 更 新 丢失 , 该 应 用 已 被 还 原 到 更 新 前 的 版 本 。 这 是 因为 Android 在 判断 系统 应 用 时 会 
检查 versionCode 的 数值 ， 如 果 versionCode 不 大 于 当前 已 安装 的 版 本 号 ， 本 次 更 新 就 被 忽略 。 


下 面 是 获取 App 版 本 信息 的 代码 片段 : 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_version); 
ImageView iv_icon = findViewById(R.id.iv_icon); 
TextView tv_desc = findViewById(R.id.tv_desc); 
iv_icon.setImageResource(R.mipmap.ic_launcher); 





Ut 
/ 先 获 取 当 前 应 用 的 包 名 ， 再 根据 包 名 获取 详细 的 应 用 信息 
了 PackageInfo pi = getPackageManager().getPackageInfo(getPackageName(), 0); 
String desc = String.format("App 名 称 为 : %s\nApp 版 本 号 为 : %d\nApp 版 本 名 称 为 : %s"， 
getResources().getString(R.string.app_name), pi.versionCode, pi.versionName); 
tv_desc.setText(desc); 
} catch (NameNotFoundException e) { 
e.printStack Trace(); 
} 


App 版 本 信息 的 获取 页 面 如 图 8-25 所 示 ， 分 别 展示 了 测 
试 App 的 应 用 图 标 、 应 用 名 称 、 应 用 的 版 本 号 以 及 版 本 名 称 。 


8.2.2 ”上线 模式 


App 名 称 为 : Test 
为 了 开发 调试 方便 , 程序 员 常 常 在 代码 里 添加 日 志 , 还 在 。 ”|APP 版 本 号 为 : 1 


App 版 本 名 称 为 ; 1.0 





页 面 上 提示 各 种 弹 窗 。 这 样 固然 有 利于 发 现 bug、 提 高 软件 质 
量 , 不 过 调试 信息 过 多 往往 容易 泄露 敏感 信息 , 例如 用 户 的 账 ”图 825 App 版 本 信息 的 获取 页 面 
写 密码 、 业 务 流程 的 逻辑 等 。 从 保密 需要 考虑 ，App 在 上 线 前 需要 去 掉 多 余 的 调试 信息 ， 形 成 
上 线 模式 。 与 之 相对 的 是 开发 阶段 的 开发 模式 。 

建立 上 线 模式 的 好 处 有 以 下 3 点 : 


(1) 保护 用 户 的 敏感 账户 信息 不 被 泄露 。 
(2) 保护 业务 逻辑 与 流程 处 理 信息 不 被 泄露 。 
(3) 把 异常 信息 转换 为 更 友好 的 提示 信息 ， 改 善 用 户 体验 。 


上 线 模式 不 是 简单 的 把 调试 代码 删 掉 ， 而 是 通过 某 个 开关 控制 是 否 显 示 调 试 信息 ， 因 为 
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App 后 续 还 得 修改 、 更 新 、 重 新 发 布 ， 这 个 迭代 过 程 要 不 断 调 试 ， 从 而 实现 并 验证 新 功能 。 具 
体 地 说 ， 就 是 建立 几 个 公共 类 ， 代 码 中 涉及 输入 调试 信息 的 地 方 都 改 为 调用 公共 类 的 方法 ; 然 
后 在 公共 类 中 定义 几 个 布尔 变量 作为 开关 , 在 开发 时 打开 调试 , 在 上 线 时 关闭 调试 ， 从 而 实现 
开发 模式 和 上 线 模式 的 切换 。 

控制 调试 信息 的 公共 类 主要 有 3 种 ， 分 别 对 Log 类 、Toast 类 和 AlertDialog 类 进行 封装 ， 
详细 说 明 如 下 : 


1. 日 志 Log 
Log 类 用 于 打印 调试 日 志 。 调试 App 时 ， 日 志 信息 会 输出 到 控制 台 console 窗口 。 因 为 最 


终 用 户 看 不 到 App 日 志 ， 所 以 除非 特殊 情况 ， 发 布 上 线 的 App 应 屏蔽 所 有 日 志 信息 。 
下 面 是 日 志 工具 类 的 代码 : 


public class LogTool { 
public static boolean isShown = 包 lse;“// false 表示 上 线 模式 ，true 表示 开发 模式 








public static void v(String tag, String msg) { 


if (isShown) { 
Log.v(tag, msg); / 打印 元 余 日 志 
} 
b 
public static void d(String tag, String msg) { 
if (isShown) { 
Log.d(tag, msg); / 打印 调试 日 志 
} 
b 
public static void i(String tag, String msg) { 
if (isShown) { 
Log.i(tag, msg); / 打印 一 般 日 志 
} 
’; 
public static void w(String tag, String msg) { 
if (isShown) { 
Log.w(tag, msg); / 打印 警告 日 志 
} 


} 


public static void e(String tag, String msg) { 
if (isShown) { 
Log.e(tag, msg); // 打印 错误 日 志 
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} 


} 

2. 提示 Toast 

Toast 类 用 于 在 界面 下 方 弹出 小 窗 , 给 用 户 一 两 句 话 的 提示 ,小 窗 短暂 停留 一 会 儿 后 消失 。 
Toast 窗口 无 交互 动作 ， 样 式 也 基本 固定 ， 因 此 除了 少数 弹 窗 可 予以 保留 (如 “再 按 一 次 返回 
键 退 出 ”) ， 其 他 弹 窗 都 应 在 发 布 时 屏蔽 。 

下 面 是 提示 工具 类 的 代码 : 

public class ToastTool { 

public static boolean isShown = 包 lse; V// false 表示 上 线 模式 ，true 表示 开发 模式 











public static void showShort(Context ctx, String msg) { / 显示 短 提示 
if (isShown) { 
Toast.make Text(ctx, msg, Toast.LENGTH SHORT).show(); 
} 
b 


public static void showLong(Context ctx, String msg) { / 显示 长 提示 
if (isShown) { 
Toast.make Text(ctx, msg, Toast.LENGTH_LONG).show(); 
! 
由 


public static void showQuit(Context ctx) { 
Toast.makeText(ctx, "再 按 一 次 返回 键 退 出 ! ", Toast LENGTH_SHORT).show(); 
1 


3. 提醒 对 话 框 AlertDialog 


提醒 对 话 框 常用 于 各 种 与 用 户 交 互 的 操作 ， 如 果 是 业务 逻辑 需要 ， 该 对 话 框 就 无 须 区 分 
不 同 模式 ; 如 果 是 提示 错误 信息 ,对 话 框 就 应 该 针对 两 种 模式 做 不 同 处 理 。 若 是 开发 模式 ， 则 
对 话 框 展示 完整 的 异常 信息 ， 包 括 输入 参数 、 异 常 代码 、 异 常 描述 等 ,若是 上 线 模式 ， 则 对 话 
框 展示 相对 友好 的 提示 文字 ， 如 “当前 网 络 连 接 失 败 ， 请 检查 网 络 设置 是 否 开启 ”等 。 
下 面 是 对 话 框 工具 类 的 代码 : 
public class DialogTool { 
public static boolean isShown = 包 lse; V// false 表示 上 线 模式 ，true 表示 开发 模式 
public static int SYSTEM = 0; / 系统 异常 
public static int IO = 1; / 输入 输出 异常 
public static int NETWORK = 2; / 网 络 异 常 
private static String[] mEror = {" 系 统 异常 ， 请 稍 候 再 试 ", " 读 写 失败 ， 请 清理 内 存 空间 后 再 试 "， 
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"网 络 连接 失败 ， 请 检查 网 络 设置 是 否 开启 "}; 


/ 根据 错误 的 类 型 、 名 称 。 代 码 、 描 述 ， 弹 出 相应 的 提醒 对 话 框 
public static void showError(Context ctx, int type, String title, int code, String msg) { 
AlertDialog.Builder builder = new AlertDialog.Builder(ctx); 
if (isShown) { 
String desc = String.format("%s\n 异常 代码 : %dn 异常 描述 : %s", mError[type], code, msg); 
builder.setMessage(desc); 
}else{ 
builder.setMessage(mError[type]); 
} 
builder.setTitle(title).setPositiveButton(" 确 定 ", null); 
builder.create().show(); 
’ 


// 处 理 异常 信息 
public static void showError(Context ctx, int type, String title, Exception e) { 
if (isShown) { 
e.printStackTrace(); // 把 异常 的 栈 信息 打印 到 日 志 中 
} 
showError(ctx, type, title, -1, e.getMessage()); 


} 
除了 代码 外 ，AndroidManifest.xml 还 要 区 分 开发 模式 与 上 线 模式 ， 有 以 下 3 点 修改 说 明 。 


(1) application 标签 中 加 上 属性 android:debuggable="true" 表 示 调 试 模式 ， 默 认 false 表示 
上 线 模式 。 若 在 模拟 器 上 调试 或 通过 Android Studio 直接 把 App 安装 到 手机 上 ， 则 无 论 

debuggable 的 值 是 多 少 都 直接 切换 到 调试 模式 。 在 上 线 发 布 时 要 把 该 属性 设置 为 false。 

(2) App 发 布 后 ， 没 有 特殊 情况 ， 开 发 者 都 不 希望 activity 和 service 对 外 开放 。 但 其 默 
认 是 对 外 部 开放 的 , 所 以 要 在 activity 和 service 标签 下 分 别 添加 属性 android:exported= "false"， 
表示 该 组 件 不 对 外 开放 。 

(3) App 默认 安装 到 内 部 存储 ， 因 为 手机 与 平板 的 存储 空间 有 限 ， 所 以 应 该 尽量 让 App 
选择 安装 到 SD 卡 ， 避 免 占 用 宝贵 的 内 部 存储 空间 。 这 时 要 在 manifest 标签 下 加 上 属性 
android:installLocation， 该 属性 的 取 值 说 明 见 表 8-1。 


表 8-1 安装 位 置 的 取 值 说 明 


安装 位 置 的 类 型 ”| 说 明 











internalOnly | 默认 值 ， 只 能 安装 在 内 部 存储 。 无 法 通过 安全 软件 的 应 用 搬家 功能 将 其 挪 到 SD 卡 
auto 优先 装 在 内 部 存储 ,但 车 内 部 存储 空间 不 足 ， 则 会 安装 在 SD 卡 。 安 装 之 后 ， 用 户 可 通过 


安全 软件 选择 是 否 将 其 挪 到 SD 卡 。 推 荐 设 为 该 值 


preferExtemal 安装 在 SD 卡 上 。 但 车 SD 卡 不 存在 或 SD 卡 空间 不 足 ， 则 安装 在 内 部 存储 
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8.2.3 数据 加 密 


大 家 都 知道 ， 数 据 安 全 很 重要 ， 现 在 无 论 干什么 都 要 密码 ， 各 种 账号 和 密码 一 旦 泄露 必 
将 造成 财产 损失 。 但 是 Android 对 数据 安全 的 支持 很 弱 ， 并 没有 很 好 的 数据 保密 措施 。 

例如 ， 共 享 参数 SharedPreferences 本 质 上 是 操作 一 个 XML 配置 文件 ， 文 件 具 体 路 径 为 
/data/data/ 应 用 包 名 /shared_prefs/***.xml; 打开 shared.xml 共享 参数 文件 后 里 面 全 部 都 是 明文 : 


<?xml version='].0' encoding="utf-8' standalone='yes' ?> 
<map> 

<string name="name">Mr Lee</string> 

<int name="age" value="30" /> 

<boolean name="married" value="true" /> 

<float name="weight" value="100.0" /> 
</map> 


如 果 里 面 存放 用 户 的 银行 账号 与 密码 ， 不 要 说 是 黑客 ， 就 是 一 个 App 初学 者 拿 到 别人 手 
机 后 也 一 样 容易 获得 其 中 的 用 户 账号 信息 。 

SQLite 数据 库 也 不 安全 ， 数 据 库 文件 具体 路 径 为 /data/data/ 应 用 包 名 /databases/***.db。 这 
个 db 文件 未 经 加 密 处 理 ， 只 要 弄 来 sqlitemanager、SQLiteStudio 等 SQLite 的 管理 工具 ， 就 能 
查看 数据 库 中 存储 的 各 种 信息 。 图 8-26 所 示 为 使 用 sqlitemanager 查看 某 App 数据 库 的 表 记 录 。 


onle, [eit 


parentld 





8-26 SQLite 保存 的 数据 记录 信息 


又 如 图 8-27 所 示 ， 这 是 功能 更 为 强大 的 SQLiteStudio 偷窥 到 的 App 数据 库 信息 ， 
SQLiteStudio 不 但 能 够 浏览 各 表 的 数据 ， 还 能 进行 增删 改 等 管理 操作 。 
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8-27 利用 SQLiteStudio 查看 SQLite 数据 库 
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所 以 说 ， 用 户 数据 不 管 是 保存 在 SharedPreferences， 还 是 保存 在 SQLite 数据 库 ， 都 很 有 
必要 对 关键 数据 进行 加 密 。 加 密 算法 多 种 多 样 ， 常 见 的 有 MD5、RSA、AES、3DES、SM3 这 
5 种 ， 分 别 介 绍 如 下 。 


1. MD5 加 密 


MD5 是 不 可 逆 的 加 密 算 法 ， 也 就 是 无 法 解密 ， 主 要 用 于 客户 端的 用 户 密码 加 密 。MD5 算 
法 的 加 密 代码 如 下 : 


public class MDSUtil { 
public static String encrypt(String raw) { 
String md5Str = raw; 
try{ 

MessageDigest md = MessageDigest.getInstance("MD5"); / 创建 一 个 MD5 算法 对 象 
md.update(raw.getBytes()); / 给 算法 对 象 加 载 待 加 密 的 原始 数据 
byte[] encryContext = md.digest0; / 调用 digest 方法 完成 哈 希 计算 
int i; 

StringBuffer buf = new StringBuffer(™"); 
for (int offset = 0; offset < encryContext.length; offset++) { 
i= encryContext[offset]; 

if(i<0){ 

i+= 256; 
if(i<16) 上 
buf.append("0"); 

1 

bufappend(IntegertoHexString(D); / 把 字 节 数组 逐 位 转换 为 十 六 进 制 数 
} 
md5Str = buftoString(; / 拼装 加 密 字符 串 

} catch (NoSuchAlgorithmException e) { 
e.printStack Trace(); 
} 
return md5Str.toUpperCase(); // 输出 大 写 的 加 密 串 


} 

MD5 算法 的 加 密 效 果 如 图 8-28 所 示 ， 无 论 原始 字 
符 串 是 什么 , MD5 加 密 串 都 是 32 位 的 十 六 进 制 字符 串 。 

2. RSA 加 密 





要 加 密 的 字符 串 : 123abc 


MD5 加 密 RSA 加 密 AES 加 密 
RSA 算法 在 客户 端 使 用 公 钥 加 密 ， 在 服务 端 使 用 私 有 本 i 
钥 解密 。 这 样 一 来 ， 即 使 加 密 的 公 钥 被 泄露 ， 没 有 私 钥 。 |MDs 的 加 密 结果 是 :A906449D5769FA7361 
仍然 无 法 解密 。 D7ECC6AA3F6D28 
图 8-28 MD5 算法 的 加 密 结果 
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下 面 是 RSA 加 密 的 3 个 注意 事项 。 


(1) 需要 导入 加 密 算 法 的 依赖 包 bcprov-jdk16-1.46.jar， 该 jar 包 要 放 在 当前 模块 的 libs 
目录 下 。 

(2) RSA 加 密 的 结果 是 字 节 数组 ， 经 过 BASE64 编码 才能 形成 最 终 的 加 密 字符 串 。 

(3) 依据 需求 要 对 加 密 前 的 字符 串 做 reverse 倒序 处 理 。 


RSA 加 密 的 代码 量 较 大 ， 篇 幅 所 限 就 不 贴 了 ， 读 者 可 参考 本 书 附 带 源码 test 模块 的 
RSAUtiljava。RSA 算法 的 加 密 效 果 如 图 8-29 所 示 ， 加 密 结果 是 经 过 URL 编码 的 字符 串 。 





要 加 密 的 字符 串 ，123abc 


MD5 加 密 RSA 加 密 AES 加 密 


3DES 加 密 SM3 国 密 


RSA 的 加 密 结果 是 :niP61382A 
%2FrupcBbOTI1iZSS5%2BF3dkCBiKI 
RH22YfDF1sjS7Bj34BJycaUkADWY 
52pITRPoY3XU4ozqoQU6jh1hY3ixn 
%2BWFY7MI7I4EC1XZ3WxxfXAd0g 
%2FEngp%2Bi9pbl40%2FggFSXJu6nv 
knV7pQTYyJId%2B2XD5bLJ7kBEGcHiwLY 
%3D 





图 8-29 RSA 算法 的 加 密 结果 
3.AES 加 密 


AES 是 设计 用 来 替换 DES 的 高 级 加 密 算法 ， 因 为 它 采取 对 称 密 钥 加 密 ， 所 以 允许 逆向 解 
密 。Android 开发 运用 AES 加 解密 时 ， 需 注意 不 同系 统 版 本 的 适 配 问 题 ， 以 Android 4.2 和 
Android 7.0 两 个 版 本 为 分 水 岭 ， 共 有 三 种 情景 要 区 别 对 待 。 另 外 ， 注 意 Android 9.0 彻底 去 除 
了 名 叫 Crypto 的 密 钥 提供 者 , 原因 是 它 仅 有 的 SHA1PRNG 算法 属于 弱 加 密 ， 导致 密码 容易 遭 
到 破解 ， 故 而 Android 9.0 之 后 不 能 再 使 用 Crypto 和 SHA1PRNG 相关 算法 。 下 面 是 AES 算法 
获取 随机 种 子 时 的 不 同系 统 适 配 代码 片段 , 完整 代码 见 本 书 附带 源码 test 模块 的 AesUtil.java。 


private static byte[] getRawKey(byte[] seed) throws Exception { 
KeyGenerator kgen = KeyGenerator.getInstance(Algorithm); 
// SHA1PRNG 强 随机 种 子 算法 , 要 区 别 Android 7.0 以 上 及 Android 4.2 以 上 版 本 的 调用 方法 
SecureRandom sr; 
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { 
// Android 7.0 及 以 上 版 本 的 随机 种 子 生成 写法 
sr = SecureRandom.getInstance("SHA1PRNG", new CryptoProvider()); 
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN MRI) { 
/Android 4.2 及 以 上 版 本 的 随机 种 子 生成 写法 
st = SecureRandom.getInstance("SHA 1PRNG", "Crypto"); 
}else{ 





/Android 4.1 及 以 下 版 本 的 随机 种 子 生 成 写法 
sr = SecureRandom.getInstance("SHA1PRNG"); 
} 
sr.setSeed(seed); 
kgen.init(256, sD; /256 位 或 128 位 或 192 位 
SecretKey skey = kgen.generateKey(); 
return skey.getEncoded(); 
| 


// Android 7.0 放弃 了 SHAIPRNG 算法 的 默认 提供 者 Crypto, 开发 者 需要 改 为 自 定义 的 密 钥 提供 者 
public static final class CryptoProvider extends Provider { 


public CryptoProviderO { 
super("Crypto", 1.0, "HARMONY (SHA1 digest SecureRandom; SHA 1 withDSA signature)"); 
put("SecureRandom.SHA1PRNG", 
"org.apache.harmony.security.provider.crypto.SHA1PRNG_SecureRandomImp!"); 
put("SecureRandom.SHA1PRNG ImplementedIn", "Software"); 


| 
AES 算法 的 加 密 效果 如 图 8-30 所 示 。 该 算法 是 可 逆 算 法 ， 支 持 对 加 密 字符 串 进行 解密 ， 
前 提 是 解密 时 密 钥 必须 与 加 密 时 一 致 。 


4. 3DES 加 密 
3DES (Triple DES) 是 三 重 数 据 加 密 算法 ， 相 当 于 对 每 个 数据 块 应 用 3 次 DES 加 密 算法 。 








因为 原先 DES 算法 的 密 钥 长 度 过 短 ， 容 易 遭 到 暴力 破解 ， 所 以 3DES 算法 通过 增加 密 钥 的 长 
度 防 范 加 密 数 据 被 破解 。 在 实际 开发 中 ，3DES 的 密 钥 必 须 是 24 位 的 字 节 数组 ， 过 短 或 过 长 


在 运行 时 都 会 报错 java.security.InvalidKeyException。 另 外 ，3DES 加 密生 成 的 是 字 节 数 组 ， 也 
得 通过 BASE64 编码 为 文本 形式 的 加 密 字符 串 。 

3DES 的 加 解密 代码 参见 本 书 附带 源码 test 模块 的 Des3Utiljava， 它 的 加 密 效果 如 图 8-31 
所 示 。 该 算法 与 AES 一 样 是 可 逆 算 法 ， 支 持 对 加 密 字符 串 进行 解密 ， 前 提 是 解密 时 密 钥 必须 
与 加 密 时 一 致 。 





要 加 密 的 字符 串 ，123abc 要 加 密 的 字符 串 : 123abc 
MD5 加 密 RSA 加 密 AES 加 密 MD5 加 密 RSA 加 密 AES 加 密 
3DES 加 密 SM3 国 密 3DES 加 密 SM3 国 密 
AES 的 加 密 结果 是 :B560BD50C3472752A3 3DES 的 加 密 结果 是 :QarAYI5FBXY= 
E906C1CBCBB5E9 解密 结果 是 :123abc 


解密 结果 是 :123abc 





图 8-30 AES 算法 的 加 密 结果 8-31 3DES 算法 的 加 密 结果 
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5. SM3 加 密 


前 面 四 种 加 密 算法 按理 够 用 了 ， 谁 料 2005 年 中 国 的 王小云 一 举 攻破 MD5 和 SHA1 两 大 
算法 , 通过 “ 王 氏 攻击 ”的 碰撞 信息 对 ， 即 使 是 个 人 电脑 也 仅 需 几 分 钟 就 能 找到 破解 方法 。 此 
事 可 让 美国 政府 吓 坏 了 ， 从 来 具有 他 们 要 流氓 的 份 ， 没 想到 自家 后 院 起 火 了 。 于 是 乎 ， 美 国 国 
家 标准 技术 研究 院 一 边 宣布 美国 政府 五 年 内 不 再 使 用 SHA1， 一 边 于 2007 年 面向 全 球 征集 新 
的 国际 标准 密码 算法 。 之 前 介绍 AES 算法 时 提 到 ，Android 从 7.0 开始 不 再 支持 原来 的 密 钥 提 
供 者 ， 这 便 是 “ 王 氏 攻击 ”造成 的 连锁 效应 之 一 。 连 谷歌 公司 都 如 此 仓皇 失措 ， 密 码 学 基础 动 
摇 产 生 的 业界 巨大 地 震 ， 可 见 一 斑 。 

中 国学 者 不 但 完成 了 基于 哈 希 函 数 的 加 密 算 法 破解 ， 而 且 对 更 先进 密码 算法 的 制定 也 走 
在 了 世界 前 列 。 早 在 2010 年， 中 国 国家 密码 管理 局 就 向 全 社会 公布 了 “SM3 密码 杂凑 算法 ” 
的 技术 标准 ， 即 《 国 密 局 公告 第 22 号 》， 详 情 可 在 国家 密码 管理 局 官网 查阅 

(http://www.sca.gov.cn/) 。2017 年 4 月 ,国家 密码 管理 局 又 发 布 了 公告 《关于 使 用 SHA-1 密 
码 算法 的 风险 提示 》, 要 求 相关 单位 及 时 采用 SM3 等 国产 密码 算法 , 公告 内 容 如 图 8-32 所 示 。 


关于 使 用 SHA-1 密 码 算法 的 风险 提示 


2017-04-03 ”来 源 : 民 衣 宫 码 管理 局 


[# 条 :大 中 小 名 i < 回回 
































近期 , SHA-1 杂 读 密 码 算法 碰撞 攻击 实例 公布 , 对 SHA-1 算 法 的 攻击 从 理论 变 为 现实 , 继续 使 用 SHA-1 算 法 存在 重大 安全 风险 。 相 
关 单位 应 遵循 密码 国家 标准 和 行业 标准 , 全 面 支持 和 应 用 SM3 等 国产 密码 算法 , 严格 按照 《商用 密码 管理 条 例 》 等 相关 法 律 法 规 的 
要 求 开展 商用 密友 研发、 生产、 销售、 使 用 等 活动 。 


国家 密码 管理 局 
2017 年 4 月 03 日 








8-32 ” 国 密 局 提示 SHA-1 算法 风险 的 公告 
MD5 的 加 密 结果 是 32 位 的 字符 串 ，SM3 的 加 密 结果 则 是 64 位 的 字符 串 ， 周 密 的 安全 防 
护 使 之 坚不可摧 。 据 统计 ，SM3 已 为 中 国 多 个 行业 保驾 护航 ， 多 款 产 品 在 国内 大 范围 使 用 ， 
受 SM3 保护 的 智能 电网 用 户 高 达 6 亿 多 , 含 SM3 的 USBKey 出 货 量 过 10 亿 张 , 银行 卡 过 亿 。 
心动 不 如 行动 , 赶快 瞧 瞧 SM3 有 何 过 人 之 处 ， 它 的 数据 加 密 范例 如 图 8-33 所 示 ， 更 多 实现 代 
码 参 考 本 书 附带 源码 test 模块 的 SM3Digest.java。 


要 加 密 的 字符 串 : 123abc 
MD5 加 密 RSA 加 密 AES 加 密 


3DES 加 密 SM3 国 密 


SM3 的 加 密 结果 是 :8E4AF598200DD9164F 
344CAEBAAE4F7B1C825FC09BD9A483 
C5ACAE81D3448BB2 


图 8-33 ”SM3 算法 的 加 密 结果 
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8.3 ”安全 加 固 


本 节 介 绍 对 APK 安装 包 进行 安全 加 固 的 过 程 。 首 先 通过 反 编 译 工具 成 功 破解 App 源码 ， 
从 而 表明 对 APK 实施 安全 防护 的 必要 性 和 紧迫 性 ， 接 着 详细 说 明代 码 混淆 的 原理 与 规则 ， 演 
示 代 码 混 淆 如 何 加 大 源码 破译 的 难度 ; 然后 描述 怎样 利用 第 三 方 加 固 网 站 对 APK 做 加 固 处 理 ; 
最 后 演示 对 加 固 包 进行 重 签名 的 方法 。 

8.3.1 反 编 译 
编译 是 把 代码 编译 为 程序 ， 反 编译 是 把 程序 破解 为 代码 

谁 都 不 想 自 己 的 劳动 成 果 被 别人 窃取 , 何况 是 辛 辛 出 来 的 App 代码 , 然而 由 于 Java 
语言 的 特性 ，Java 写 的 程序 往往 容易 被 反 编译 破解 ， 只 要 获得 App 的 安装 包 ， 就 能 通过 反 编 
译 工具 破解 出 该 App 的 完整 源码 。 开 发 者 绞 尽 脑汁 上 架 一 个 App， 结 果 这 个 App 却 被 他 人 从 
界面 到 代码 都 “山寨 ”了 ， 那 可 真是 欲 避 无 泪 了 。 为 了 说 明代 码 安全 的 重要 性 ， 下 面 对 反 编译 
的 完整 过 程 进行 介绍 ， 警 醒 开发 者 防火 、 防 盗 、 防 破解 。 

首先 准备 反 编译 的 3 个 工具 ， 分 别 是 apktool、dex2jar、jd-gui， 注 意 下 载 最 新 版 本 。 

@ apktool: 对 APK 文件 进行 解 包 ， 主 要 用 来 解析 res 资源 和 AndroidManifest.xml。 

@ dex2jar: 将 APK 包 中 的 classes.dex 转 为 JAR 包 ， 该 JAR 包 就 是 App 代码 的 编译 文件 。 

@ jd-gui: 将 dex2jar 解析 出 来 的 jar 包 反 编译 为 Java 源码 。 

下 面 是 反 编 译 APK 的 具体 步骤 (以 Window 环境 举例 说 明 ) 。 

CJ01 打开 DOS 命令 窗口 ， 进 入 apktool 所 在 的 目录 ， 运 行 “apktool.bat d -f 解 包 后 的 保存 目 
录 名 待 处 理 的 APK 文件 名 ” 等 待 反 编译 过 程 ， 如 图 8-34 所 示 。 



































图 8-34 ” 反 编译 工具 apktool 的 运行 截图 








反 编 译 通过 ， 即 可 在 当前 目录 下 看 到 破解 目录 。apktool 的 主要 目的 是 解析 出 res 资源 ， 包 括 
AndroidManifestxml 和 res/layout、res/values、res/drawable 等 目录 下 的 资源 文件 。 
人 ED2 用 压缩 软件 (如 Winrar) 打开 APK 包 ，APK 安装 包 其 实 是 一 个 压缩 文件 ， 使 用 Winrar 
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打开 APK 文件 的 目录 结构 如 图 8-35 所 示 。 


F 
test-debus. apk - WinRAR 二 eis 


















































文件 他) 命令 (C) 工具 (S) 收藏 夹 (0) 选项 (人 帮助 (8) 
移 册 大 吧 昌 晴 奏 是 | 刻 ， 
添加 解压 到 测试 ”查看 。 划 除 癌 信息 | 扫描 病毒 半 
国 : 国 test-debug. apk - ZIP 压缩 文件 ， 解 包 大 小 为 5, 172, 179 字 节 ~ 
名 称 大 小 ”压缩 后 大 小 类 型 
.图 文件 夹 
Bres 文件 夹 
Borg 文件 夹 
BAETA-INF 文件 夹 
Lresources. arsc 206, 596 206, 596 ARSC 文件 
口 classes. dex 由 501,672 ”1,382,504 DEX 文件 
| Dandroidlanifest. ml 2,184 767 XML 文件 
2 一 吉 "| ; 
EP 总 计 3 文件 夹 和 4,710, 452 字 节 








8-35 Apk 解压 后 的 内 部 目录 结构 


先 从 APK 包 中 解压 出 classes.dex 文件 ， 再 进入 dex2jar 所 在 的 目录 ， 运 行 命令 d2j-dex2jarbat 
classes.dex， 等 到 破解 完成 ， 即 可 在 当前 目录 下 看 到 新 文件 classes_dex2jarjar， 该 JAR 包 即 为 App 源 
码 的 编译 文件 。 

本 03 双击 打开 jd-gui.exe， 用 鼠标 把 classes_dex2jarjar 拖 到 jd-gui 界面 中 ， 程 序 就 会 自动 把 
JAR 包 反 编译 为 Java 源码 ， 反 编译 后 的 Java 源码 目录 结构 如 图 8-36 所 示 。 


ED Java Decompiler - Logiool. class 
Eile Edit Havigate Search Help 
各 


A 

| dasses dex2jar.jar x 

让 二 androld. support 
应 - 南 com. exanple. test 











jpackage Con.erample. test.acil; 


时 页 encrypt 
且 志 base64 a limport android. uei1.Log; 
四 由 tool 
由 国 AesUtil jpublic class Logrcol 
由 : 国 Des3Util [ 
相国 MD5UYil public static boolean isSboy = false; 


困 - 国 RSAU+11 
日 - 吊 util ri static void d(String FaremStringl, String paramString2) 
中 国 DislegTool If (iashor 一 true) { 
品目 SEE Teg.d(paransrring1，paranSrring2): 
EB-@LosTool } 
osisShow : boolean } 
es d(String，String) : void 
ee(String，StTing) : void public atatic void e(3tring Farem3tring1，3scing Parem3cring2) 
1(String, String) : void 上 中 三 
pt ed eleanor ting, paranstringa); 
@Swvtf (string, String) : void J 
由 - 国 ToastTool 


1 


由 国 Buildconfte Publie static void ilSrring Faramsrriag1，Scring paramScring2) 
由 国 Encrypthctivity { 

由 国 Mainhctivity if (isshor 一 true) { 

由 - 国 R Leg.i(paranStringl, paranString2); 





由 - 国 Yersionhctivity 1 
自作 org. bouncycastle ] 











图 8-36 反 编 译 后 的 java 源码 目录 结构 


在 jd-gui 界面 依次 选择 菜单 File 一 Save All Sources， 输 入 保存 路 径 ， 在 指定 目录 生成 zip 文件 ， 
解压 zip 文件 就 能 看 到 反 编 译 后 的 全 部 Java 代码 了 。 


上 面 的 反 编 译 过 程 不 但 破解 了 Java 代码 ， 而 且 res 资源 文件 也 被 一 起 破解 了 ， 所以， 如 果 
你 的 App 不 采取 一 些 保护 措施 ， 整 个 工程 源码 就 会 暴露 在 大 庭 广 众 之 下 。 
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8.3.2 ”代码 混淆 


前 面 讲 到 反 编 译 能 够 破解 App 的 整个 工程 源码 ， 因 此 有 必要 对 App 源码 采取 防护 措施 ， 
代码 混淆 就 是 保护 代码 安全 的 措施 之 一 。Android Studio 已 经 自 带 了 代码 混淆 器 ProGuard， 用 
途 包括 以 下 两 点 : 


(1) 压缩 APK 包 的 大 小 ， 删 除 无 用 代码 ， 并 简化 部 分 类 名 和 方法 名 。 
(2) 加 大 破解 源码 的 难度 ， 部 分 类 名 和 方法 名 被 重 命名 使 得 程序 逻辑 变 得 难以 理解 。 


代码 混淆 的 配置 文件 其 实 一 直 都 存在 , 只 是 我 们 之 前 都 将 其 忽略 了 。 每 次 在 Android Studio 
新 建 一 个 模块 ,该 模块 的 根 目录 下 都 会 自动 生成 proguard-rules.pro 打 开 build.gradle, 在 android 
一 buildTypes 一 release 节点 下 可 以 看 到 两 行 编译 配置 : 


minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt"), 'proguard-rules.pro' 


Android Studio 默认 不 做 代码 混淆 ， 上 面 第 一 行 的 minifyEnabled 为 false 表示 关闭 混淆 功 
能 ， 要 把 该 参数 改 为 true 才能 开启 混淆 功能 。 第 二 行 配 置 指定 proguard-rules.pro 作为 本 模块 
的 代码 混淆 文件 ， 该 文件 保存 的 是 各 种 详细 的 代码 混淆 规则 。 

下 面 是 proguard-rules.pro 的 一 个 模板 : 


# 指 定 代码 的 压缩 级 别 

-Optimizationpasses 5 

# 是 否 使 用 大 小 写 混合 

-dontusemixedcaseclassnames 

# 优 化 /不 优化 输入 的 类 文件 

-dontoptimize 

# 是 否 混淆 第 三 方 JAR 包 

-dontskipnonpubliclibraryclasses 

# 混 淆 时 是 否 做 预 校 验 

-dontpreverify 

# 混 淆 时 是 否 记录 日 志 

-Verbose 

检 昆 淆 时 所 采用 的 算法 

-Optimizations !code/simplification/arithmetic, !field/*,!class/merging/* 

# 保 护 注解 

-keepattributes *+Annotation* 

# 保 持 JNI 用 到 的 native 方法 不 被 混淆 

-keepclasseswithmembers class + { 
native <methods>; 








} 
# 保 持 自 定义 控件 的 构造 函数 不 被 混淆 ， 因 为 自 定义 控件 很 可 能 直接 写 在 布局 文件 中 
-keepclasseswithmembers class + { 
public <init>(android.content.Context, android.util.AttributeSet); 
} 
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# 保 持 自 定义 控件 的 构造 函数 不 被 混淆 
-keepclasseswithmembers class * { 

public <init>(android.content.Context, android.util.AttributeSet, int); 
} 
# 保 持 布局 中 onClick 属性 指定 的 方法 不 被 混淆 
-keepclassmembers class * extends android.app.Activity { 

public void *(android.view.View); 

b 
# 保 持 枚 举 enum 类 不 被 混淆 
-keepclassmembers enum * { 

public static **[] values(); 

public static ** valueOf(java.lang. String); 
} 
# 保 持 序列 化 的 Parcelable 不 被 混淆 
-keep class * implements android.os.Parcelable { 

public static final android.os.Parcelable$Creator *; 
} 
# 指 定 哪 些 第 三 方 JAR 包 需 要 混淆 
#-libraryjars libs/bcprov-jdk16-1.46.jar 
# 保 持 哪些 系统 组 件 类 不 被 混淆 
-keep public class * extends android.app.Fragment 
-keep public class * extends android.app.Activity 
-keep public class * extends android.app.Application 
-keep public class * extends android.app.Service 
-keep public class * extends android.content.BroadcastReceiver 
-keep public class * extends android.content.ContentProvider 
-keep public class * extends android.app.backup.BackupAgentHelper 
-keep public class * extends android.preference.Preference 
-keep public class * extends android.support.v4.** 
-keep public class com.android.vending .licensing.ILicensingService 
# 保 持 哪 些 第 三 方 JAR 包 不 被 混淆 。 比 如 上 一 节 RSA 算法 用 到 了 bcprov-jdk16-1.46.jar, 该 JAR 包 里 的 
工具 类 就 不 可 混淆 

-keep class org.bouncycastle.** 
-dontwarn org.bouncycastle.** 


进行 代码 混淆 时 有 以 下 5 点 注意 事项 : 

(1) 对 某 些 特殊 的 类 或 方法 屏蔽 混淆 ， 可 能 会 在 布局 文件 中 直接 引用 类 名 或 方法 名 ， 包 
括 自 定义 控件 、 布 局 中 onClick 属性 指定 的 方法 等 。 

(2) 保持 第 三 方 JAR 包 不 被 混淆 ， 有 时 需要 把 keep class 提 到 dontwarn 前 面 。 

(3) JAR 包 的 文件 名 中 不 要 有 特殊 字符 ， 比 如 “(”“)” 等 字符 在 混淆 时 会 报错 ， 文 件 
名 最 好 只 包含 字母 、 横 线 、 小 数 点 。 

(4) jni 的 方法 要 屏蔽 混淆 ， 因 为 so 库 要 求 包 名 、 类 名 、 函 数 名 完全 一 致 。 
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(5) 使 用 WebView 时 会 被 js 调用 的 类 和 方法 也 要 屏蔽 混淆 。 有 具体 做 法 除了 要 在 


proguard-rules.pro 加 上 说 明 外 ， 还 要 在 Java 代码 中 调用 js 使 用 的 方法 ， 才 能 保证 内 部 类 与 相 
关 方 法 都 没有 被 混淆 。 


-keep class com.example.mixture.WebActivity$MobileSignal{ 


b 


public <fields>; 
public <methods>; 


经 过 代码 混淆 后 重新 生成 的 APK 文件 ， 再 用 反 编译 工具 进行 破解 ， 反 编译 后 的 Java 源码 
结构 如 图 8-37 所 示 。 


加 a | 


File Edit Navigate Search Help 
局 | 自用 | 定时 


dasses-dex2jarjar x 


时 二 androtd. eppert | 


后 - 南 con. exanple. test | 
| package com.example. test.a; 








jpublic class a 


{ 

a(String) : byte[] public static String alString paranStringl, String paranString2) 
alstring, String) : St 

WS a(StringBuffer, byte) | return blala(paranstringl.getBytes()), paranstring2.gerByces())); 
albyte[]) : byte[] 

$albyte[], byte[]) : Private static vold alScringBufter paranstringButter, byte paranByte) 
bl(string, String) : { 

Bb(byte[]) : String ParanstringBurfer.append("0123456789ABCDEF". charAt (OxF 5 pararByte 4 


$b(byte[], byte[]) : 
Private static byte[] alString paranString) 
1 


由 人 4nt 1 = paramScring.length() / 2; 
3, bytel] arrayorByre = new byte[i]; 
由 - 国 EncryptActivity for (int ] = 0; j < 1; j++) { 
由 - 国 Nainkctivity arrayOfByte[]] = Integer.valveOf(paramString.substring(] 。2，2 + 
由 - 国 VersionActivity ] 
由 出 org. bouncycastle return arrayorByre 
几 1 





8-37 ”经 过 代码 混淆 再 破解 后 的 Java 源码 目录 结构 



















从 图 中 看 到 ， 混 淆 处 理 后 的 包 名 与 类 名 都 变 成 了 a、b、c、d 这 样 的 名 称 ， 无 疑 加 大 了 黑 
客 理解 源码 的 难度 。 试 想 当 黑 客 面 对 这 些 天 书 般 的 a、b、c、d， 还 会 想 要 绞 尽 脑汁 地 尝试 破 


译 吗 ? 


8.3.3 第 三 方 加 固 及 重 签名 


App 经 过 代码 混淆 后 初步 结束 了 裸奔 的 状态 , 但 代码 混淆 只 能 加 大 源码 破译 的 难度 , 并 不 
能 完全 阻止 被 破解 。 除 了 代码 破解 外 ，App 还 存在 其 他 安全 风险 ， 比 如 二 次 打包 、 算 改 内 存 、 
漏洞 暴露 等 情况 。 对 于 这 些 安全 风险 ，Android Studio 基本 无 能 为 力 。 因 此 ， 鉴 于 术 业 有 专攻 ， 
我 们 不 如 把 APK 文件 交 给 专业 加 固 网 站 进行 加 固 处 理 。 举 个 做 得 比较 好 的 第 三 方 加 固 的 例子 ， 
360 加 固 保 的 网 址 是 http:/ijiagu.360.cn/。 开 发 者 要 先 在 该 网 站 注册 新 用 户 ， 然 后 打开 在 线 加 固 
页 面 ， 加 固 页 面 如 图 8-38 所 示 。 
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8-38 360 加 固 保 的 在 线 加 固 页 面 


单 击 该 页 面 的 “上 传 应 用 ”按钮 ， 上 传 成 功 后 跳 到 下 一 页 ， 向 下 拉 到 页 面 底部 ， 选 中 “ 正 
版 签名 ”开启 加 固 按钮 ， 如 图 8-39 所 示 。 


T 





为 确保 “ 防 二 次 打包 ”功能 正常 使 用 ,请 确认 上 传 应 用 的 答 各 为 
回 正 版 签名 口 测试 签名 





图 8-39 确认 加 固 页 面 
单 击 “开始 加 固 ” 按 钮 ， 跳 到 应 用 信息 页 面 ， 如 图 8-40 所 示 。 


下 载 应 用 


多 于 于 条 包 


2016-10-29 18:47:20 





8-40 ”加 固 后 的 应 用 信息 页 面 


应 用 信息 中 部 的 当前 状态 为 “加 固 成 功 ”， 单 击 右边 的 “下 载 应 用 ”按钮 ， 把 加 固 好 的 
安装 包 下 载 到 本 地 ， 下 载 后 的 文件 名 如 testrelease.encrypted.apk。 此 时 用 反 编 译 工具 尝试 破解 
这 个 加 固 包 ， 会 发 现 该 安装 包 变 得 无 法 破译 。 

加 固 后 的 APK 破坏 了 原来 的 签名 ， 无 法 直接 安装 到 手机 上 ， 所 以 要 对 该 文件 进行 重 签名 ， 
才能 成 为 合法 的 APK 安装 包 。 重 签名 用 到 两 个 工具 ， 分 别 是 jarsigner 和 zipalign， 有 具体 说 明 如 下 : 





1.jarsigner 


jarsigner 是 Java 自 带 的 JAR 包 签 名 工具 ， 路 径 为 Java 安装 目录 下 的 jdk/bin/jarsigner.exe， 
使 用 命令 的 格式 为 “jarsigner -verbose -keystore 密 钥 文件 全 路 径 -storepass 密 钥 文件 的 密码 
-keypass 别名 的 密码 -digestalg SHA1 -sigalg MD5withRSA -signedjar 签名 后 的 文件 名 待 签名 
的 文件 名 别名 ”。 

2. zipalign 


zipalign 是 Android 开发 工具 包 SDK 自 带 的 APK 优化 工具 ， 相 当 于 内 存 对 齐 从 而 提高 读 
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取 效 率 , 路 径 为 SDK 安装 目录 下 的 build-tools/ 版 本 号 /zipalign.exe, 使 用 命令 的 格式 为 “zipalign 
-V4 已 签名 的 文件 名 对 齐 后 的 文件 名 ”。 

下 面 对 加 固 好 的 APK 文件 进行 重 签名 ， 完 整 的 命令 如 下 : 

jarsigner -verbose -keystore testjks -storepass 111111 -keypass 111111 -digestalg SHA1 -sigalg 
MD5withRSA -signedjar test-release-signed.apk test-release.encrypted.apk test 

Zipalign -V 4 test-release-signed.apk test-release-signed-align.apk 

上 述 命 令 里 的 test-release-signed.apk 表示 签名 后 的 文件 ，test-release-signed-align.apk 表示 
对 齐 后 的 最 终 安装 包 。 

当然 , 命令 行 方式 不 够 友好 , 现在 有 专门 的 重 签名 软件 , 比如 爱 加 密 的 签名 软件 APKSign， 
下 载 该 软件 并 安装 ， 安 装 完毕 后 打开 APKSign， 该 软件 的 界面 如 图 8-41 所 示 。 

在 APKSign 界面 上 选择 待 签名 的 APK， 再 选择 签名 文件 的 路 径 ， 然 后 依次 输入 密码 、 别 
名 、 别 名 的 密码 、 签 名 后 的 存放 路 径 ， 输 入 效果 如 图 8-42 所 示 ， 最 后 单 击 “开始 签名 ”按钮 
完成 签名 操作 。 





























Psien po a Onin ren eT eee ls 
ba Enolsh 。 使 加 其 下 | 寺中 文 Englsn 。。 售 曙 部 山 
| 造反 要 签名 AP 送 和 要 符 和 APK: | 
a [Em Ane FAscudoprajectsiHalowartvtestvtestelease enaypted apk 3 | 
选民 窑 名 文件 : | 进 择 答 多 六 件 : 
EEC | in: redo olor eltet 5 | 
9 ~ | EE: eee | 
Be ee [| me: OO | 
E23 | 宇宙 Pre 
| 
正和 后 Apk 旗 放 扩 全: | szeonamie | 
Ea Ww] | ‖ sarcon: | 
开 折 天 名 二 看 日 志 | 开 角 下 名 村 看 日 册 | 
8-41 ” 爱 加 密 的 重 签名 工具 界面 图 8-42 信息 填写 好 的 重 签名 工具 界面 


8.4 发 布 到 应 用 商店 














本 节 介 绍 把 App 发 布 到 应 用 商店 的 过 程 。 首 先 要 在 应 用 商店 注册 开发 者 账号 ， 以 腾讯 
放 平 台 为 例 说 明 开发 者 注册 账号 的 步骤 ;然后 使 用 已 注册 的 开发 者 账号 在 开放 平台 上 创建 并 提 
交 应 用 ， 最 后 描述 如 何 查 看 应 用 上 线 的 审核 结果 ， 以 应 用 宝 App 为 例 说 明 搜 索 并 安装 已 上 线 
App 的 方法 。 


8.4.1 注册 开发 者 账号 


APK 文件 完成 签名 后 ， 可 谓 是 万 事 俱 备 ， 只 从 东风 了 ， 接 下 来 把 App 发 布 到 各 大 应 用 市 
场 。 主 要 的 应 用 商店 有 应 用 宝 、 百 度 手机 助手 、360 手机 助手 、 小 米 应 用 商店 、 华 为 应 用 商店 、 
吏 豆 苹 等 。 下 面 举例 说 明 如 何 将 你 的 App 发 布 到 应 用 宝 。 


332°.| 


应 用 宝 只 是 手机 上 的 应 用 商店 App 的 名 
称 ， 对 应 的 开发 者 后 台 是 腾讯 开放 平台 ， 网 址 
是 http://op.open.qq.com/。 读 者 应 该 都 有 QQ 账 
号 , 直接 用 QQ 号 码 登 录 腾 讯 开 放 平 台 , 跳 转 到 
开发 者 注册 页 面 ， 如 图 8-43 所 示 。 

如 果 是 个 人 开发 者 ， 就 单 击 左边 的 “个 人 ” 
类 型 ， 如 果 是 公司 开发 者 ， 就 单 击 右边 的 “ 公 
司 ” 类 型 。 这 里 我 们 选择 “个 人 ”类 型 ， 跳 转 
到 下 一 页 的 个 人 资料 页 面 填写 个 人 信息 ， 如 图 
8-44 所 示 ; 填写 联系 方式 ， 如 图 8-45 所 示 。 
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图 8-43 ”腾讯 开放 平台 的 开发 者 注册 页 面 


个 人 资料 填写 完成 后 ， 单 击 “ 下 一 步 ”按钮 ， 跳 转 到 验证 邮箱 页 面 。 打 开 你 的 注册 邮箱 ， 
找到 腾讯 开放 平台 的 开发 者 注册 认证 邮件 ， 点 击 邮 件 中 的 确认 链接 ， 完 成 开发 者 的 注册 认证 。 








图 8-44 


个 人 信息 的 填写 页 面 
8.4.2 创建 并 提交 应 用 





同 瑟 接 牧 市 本 运 知 弛 全 





图 8-45 ”联系 方式 的 填写 页 面 


开发 者 注册 完成 后 ， 回 到 腾讯 开放 平台 的 主页 ， 在 管理 中 心 页 面 上 单 击 “ 创 建 应 用 ” 按 


钮 ， 跳 转 到 应 用 创建 页 面 ， 如 图 8-46 所 示 。 


App ID 


1105974117 
2xXGQNoRmhMIpxMU 


APP KEY 








QQ5 联 





图 8-46 腾讯 开放 平台 的 应 用 创建 页 面 
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在 该 页 面 上 选择 最 左边 的 “移动 应 用 安 卓 ”， 然 后 单 击 下 方 的 “创建 应 用 ”按钮 ， 在 弹 
出 的 类 型 对 话 框 中 选择 “软件 ”， 如 图 8-47 所 示 。 








8-47 ”应 用 类 型 的 选择 对 话 框 


单 击 “ 确 定 ” 按 钮 ， 跳 转 到 应 用 信息 填写 页 面 ， 依 次 填写 应 用 的 各 项 基本 信息 ， 包 括 应 
用 名 称 、 应 用 类 型 、 应 用 标签 、 应 用 简介 等 ， 示 例 效果 如 图 8-48 所 示 。 


从 地 基础 到 App 上 污 


















3 © tx 人 

教育 

学 们 驶 育 。 | 大 教育 考试 出 国信 学。 否 训 学 习 ] 儿童 履 育 
ouyangshen 


Android 开 发 实战 一 从 字 其 本 到 App 上 挟 





图 8-48 应 用 信息 的 填写 页 面 
分 别 上 传 安装 包 、 应 用 图 标 ， 填 写 应 用 的 适 配 信息 ， 如 图 8-49 所 示 。 


口 负 株 通过 后 立即 发 布 


图 标 来 材 
适 配 信息 


版 权证 明 ( 可 选 





| 机 站 训 已 王 22 训 12 分 目 二 让 返回 


图 849 上 传 安装 包 、 应 用 图 标 等 信息 的 页 面 
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最 后 单 击 页 面 右 下 方 的 “提交 审核 ”按钮 ， 等 待 开放 平台 的 人 工 审 核 。 审 核 一 般 需 要 1 一 
3 个 工作 日 ， 一 旦 通过 审核 ， 你 的 QQ 邮箱 会 收 到 一 封 审 核 通 知 邮件 。 此 时 重新 打开 腾讯 开放 
平台 进入 管理 中 心 ， 页 面 上 多 了 一 个 已 上 线 应 用 的 记录 ， 如 图 8-50 所 示 。 


已 上 续 (1) 未 上 线 (2 Q 创建 应 用 








应 用 名 称 状态 上 线 时 间 应 用 等 级 日 下 载 量 总 下 载 量 操作 


起 0 87 更 新 安装 包 








8-50 管理 中 心 的 已 上 线 应 用 记录 


若 想 验证 该 App 是 否 确实 上 线 成 功 , 则 可 打开 手机 上 的 应 用 宝 App, 搜索 该 App 的 名 称 ， 
搜索 结果 会 出 现 该 App 的 应 用 信息 ， 如 图 8-51 所 示 。 





8-51 ”应 用 宝 App 上 的 应 用 搜索 结果 


点 击 该 应 用 右边 的 “下 载 ” 按 钮 ， 即 可 开始 下 载 操作 ， 下 载 完 毕 后 点 击 “ 安装” 按钮， 
App 就 可 以 成 功 安装 到 用 户 手机 上 。 


8.5 小 结 


本 章 主要 介绍 了 App 从 调试 到 发 布 的 详细 过 程 ， 包 括 调试 工作 (模拟 器 调试 、 真 机 调试 、 
导出 APK 安装 包 ) 、 准 备 上 线 〈 版 本 设置 、 上 线 模式 、 数 据 加 密 ) 、 安 全 加 固 ( 反 编译 、 代 
码 混 淆 、 第 三 方 加 固 及 重 签名 ) 、 发 布 到 应 用 商店 (注册 开发 者 账号 、 创 建 并 提交 应 用 、 从 应 
用 商店 下 载 应 用 ) 。 经 过 这 一 系列 应 用 发 布 流程 ， 完 成 了 App 从 开发 阶段 的 代码 到 用 户 手机 
上 的 应 用 的 华丽 转变 ， 实 现 App“ 开 发 ”一 “测试 ”一 “加 固 ” 一 “上 线 ” 的 完整 过 程 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 5 种 开发 技能 : 

(1) 学 会 通过 模拟 器 和 真 机 对 App 进行 调试 。 

(2) 学 会 把 App 工程 从 开发 模式 转 为 上 线 模式 。 

(3) 学 会 利用 签名 证 书 导 出 APK 安装 包 。 

(4) 学 会 对 APK 包 进 行 安全 加 固 和 重 签名 。 

(5) 学 会 把 App 发 布 到 各 大 应 用 商店 。 








设备 操作 


本 章 介绍 App 开发 常用 的 一 些 设备 操作 ， 主 要 包括 如 何 使 用 摄像 头 进行 拍照 、 如 何 使 用 
麦克 风 进 行 录音 并 结合 摄像 头 进行 录像 、 如 何 播放 录制 好 的 音频 和 视频 、 如 何 使 用 常见 传感器 
实现 业务 功能 、 如 何 使 用 定位 功能 获取 位 置信 息 、 如 何 利用 短 距离 通信 技术 实现 物 联 网 等 。 最 
后 结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 仿 微 信 的 发 现 功 能 ”的 设计 与 实现 。 


9.1 摄像 头 


本 节 介 绍 利用 摄像 头 实现 相机 功能 的 办 法 ,首先 对 表面 视图 SurfaceView 的 用 法 进行 说 明 ， 
演示 如 何 运 用 相机 类 Camera 结合 表面 视图 完成 拍照 功能 〈 含 单 拍 和 连 拍 ) 。 然 后 对 表面 视图 
的 升级 版 一 一 纹理 视图 TextureView 的 用 法 进行 阐述 , 并 演示 如 何在 新 版 Camera2 架构 中 结合 
纹理 视图 完成 拍照 功能 ( 含 单 拍 和 连 拍 ) 。 最 后 介绍 了 与 设备 操作 有 关 的 运行 时 权限 管理 。 


9.1.1 表面 视图 SurfaceView 


Android 的 绘图 机 制 是 由 UI 线程 在 屏幕 上 绘图 ， 一 般 情 况 下 不 允许 其 他 线程 直接 做 绘图 
操作 。 这 个 机 制 在 处 理 简 单 页 面 时 没什么 问题 , 因为 普通 页 面 不 会 频繁 且 大 面积 地 绘图 , 但 是 
该 机 制 在 处 理 复杂 多 变 的 页 面 时 会 产生 问题 , 比如 时 刻 变化 着 的 游戏 界面 、 拍 照 或 录像 时 不 断 
变换 着 的 预览 界面 就 会 导致 UI 线程 资源 堵塞 ， 即 界面 卡 死 的 状况 。 

表面 视图 SurfaceView 是 Android 用 来 解决 子 线程 绘图 的 特殊 视图 ,拥有 独立 的 绘图 表面 ， 
即 不 与 其 宿主 页 面 共 享 同一 个 绘图 表面 。 由 于 拥有 独立 的 绘图 表面 ,因此 表面 视图 的 界面 能 
在 一 个 独立 线程 中 进行 绘制 , 这 个 子 线程 为 泻 染 线程 。 因 为 泻 染 线程 不 占用 主线 程 资源 ,所 以 

方面 可 以 实现 复杂 而 高 效 的 UI 刷新 ， 另 一 方面 及 时 响应 用 户 的 输入 事件 。 由 于 表面 视图 具 
备 以 上 特性 ， 因 此 可 用 于 拍照 和 录像 的 预览 界面 ， 也 可 用 于 游戏 的 实时 界面 。 
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因为 表面 视图 不 在 UI 主线 程 绘图 ， 无 论 是 onDraw 方法 还 是 dispatchDraw 方法 都 没有 进 
行 绘图 操作 ， 所 以 表面 视图 必然 要 通过 其 他 途径 绘图 ， 这 个 途径 便 是 内 部 类 表面 持 有 者 
SurfaceHolder 外 部 调用 SurfaceView 对 象 的 getHolder 方法 获得 SurfaceHolder 对 象 ， 然 后 进行 
预览 界面 的 相关 绘图 操作 。 
下 面 是 SurfaceHolder 的 常用 方法 。 
elockCanvas: 锁定 并 获取 绘图 表面 的 画布 。 
e unlockCanvasAndPost: 解锁 并 刷新 绘图 表面 的 画布 。 
e@ addCallback: 添加 绘图 表面 的 回调 接口 SurfaceHolder.Callback。 回 调 接口 有 以 下 3 个 方 
法 。 
> surfaceCreated: 在 绘图 表面 创建 后 触发 ， 可 在 此 打开 相机 。 
> surfaceChanged: 在 绘图 表面 变更 后 触发 。 
> surfaceDestroyed: 在 绘图 表面 销毁 后 触发 。 


e removeCallback: 移 除 绘图 表面 的 回调 接口 。 

e isCreating: 判断 绘图 表面 是 否 有 效 。 如 果 在 别处 操作 SurfaceView， 就 要 判断 当前 绘图 表 
面 是 否 有 效 。 

egetSurface: 获取 绘图 表面 的 对 象 ， 即 预览 界面 。 

e@ setFixedSize: 设置 预览 界面 的 尺寸 。 

e@ setFormat: 设置 绘图 表面 的 格式 。 


绘图 格式 的 取 值 说 明 见 表 9-1。 
表 9-1 绘图 格式 的 取 值 说 明 








PixelFormat 类 的 绘图 格式 类 型 说 明 
TRANSPAREN 透明 
TRANSLUCENT 半 透 明 
OPAQUE 不 透明 





下 面 用 一 个 具体 的 例子 说 明 普通 视图 与 表面 视图 的 区 别 。 如 图 9-1 和 图 9-2 所 示 为 普通 视 
图 在 UI 线程 中 转动 扇形 区 域 的 效果 图 ， 前 后 两 个 界面 的 扇形 大 小 相同 ， 只 是 角度 不 同 。 











图 9-1 普通 视图 的 转动 界面 1 图 9-2 普通 视图 转 的 动 界面 2 
再 来 看 表面 视图 转动 扇形 区 域 的 效果 图 ， 此 时 开启 了 两 个 线程 ， 一 个 线程 绘制 红色 扇形 ， 
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另 一 个 线程 绘制 青色 扇形 ， 前 后 两 个 时 间 点 的 画面 如 图 9-3 和 图 9-4 所 示 。 




















图 9-3 表面 视图 的 转动 界面 1 图 94 表面 视图 的 转动 界面 2 
从 表面 视图 的 转动 效果 可 以 看 到 ， 它 与 普通 视图 在 处 理 上 的 区 别 主要 有 以 下 两 点 : 
(1) 表面 视图 允许 开启 多 个 线程 同时 进行 绘图 操作 ， 而 普通 视图 只 有 一 个 UI 线程 可 以 
绘图 。 
(2) 表面 视图 不 会 自动 清空 上 次 的 绘图 结果 ， 即 绘图 操作 是 增 量 进行 的 ， 而 普通 视图 在 
每 次 绘图 前 都 会 清空 上 次 的 绘图 结果 。 
9.1.2 ”使 用 Camera 拍照 


常言 道 ， 眼 睛 是 心灵 的 窗户 ， 那 么 相机 便 是 手机 的 窗户 了 ， 主 打 美 颜 相机 功能 的 OPPO 
和 vivo 手机 大 行 其 道 ， 可 见 对 于 手机 App 来 说 ， 如 何 恰如其分 地 运用 相机 开发 至 关 重 要 。 

在 Android 开发 中 ， 相 机 Camera 是 直接 操作 摄像 头 硬件 的 工具 类 ， 包 括 后 置 摄像 头 和 前 
置 摄像 头 ， 有 以 下 常用 方法 。 

e getNumberOfCameras: 获取 本 设备 的 摄像 头 数目 。 

e@ open: 打开 摄像 头 ， 默认 打开 后 置 摄像 头 。 如 果 有 多 个 摄像 头 ， 那 么 open(0) 表 示 打 开 后 

置 摄像 头 ，open(1) 表 示 打 开 前 置 摄像 头 。 
e@ getParameters: 获取 摄像 头 的 拍照 参数 ， 返 回 Camera.Parameters 对 象 。 


e@ setParameters: 设置 摄像 头 的 拍照 参数 。 具 体 的 拍照 参数 通过 调用 Camera.Parameters 的 
下 列 方法 进行 设置 。 


> setPreviewSize: 设置 预览 界面 的 尺寸。 

> setPictureSize: 设置 保存 图 片 的 尺寸 。 

> setPictureFormat: 设置 图 片 格式 。 一 般 使 用 ImageFormat.JPEG 表示 JPG 格式 。 

> setFocusMode: 设置 对 焦 模 式 。 取 值 Camera.Parameters.FOCUS_MODE _AUTO 只 会 自动 
对 焦 一 次 ， 取 值 FOCUS_MODE_CONTINUOUS_PICTURE 则 会 连续 对 焦 。 


esetPreviewDisplay: 设置 预览 界面 的 表面 持 有 者 ， 即 SurfaceHolder 对 象 。 该 方法 必须 在 
SurfaceHolder.Callback 的 surfaceCreated 方法 中 调用 。 
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@ startPreview: 开始 预览 。 该 方法 必须 在 setPreviewDisplay 方法 之 后 调用 。 
。 unlock: 录像 时 需要 对 摄像 头 解锁 , 这 样 摄像 头 才能 持续 录像 。 该 方法 必须 在 startPreview 


方法 之 后 调用 。 

setDisplayOrientation: 设置 预览 的 角度 。Android 的 0 度 在 三 点 钟 的 水 平 位 置 ， 而 手机 屏 
幕 是 垂直 位 置 ， 从 水 平 位 置 到 垂直 位 置 需要 旋转 90 度 。 

autoFocus: 设置 对 焦 事 件 。 参 数 自动 对 焦 接 口 AutoFocusCallback 的 onAutoFocus 方法 在 
对 焦 完成 时 触发 ， 在 此 提示 用 户 对 焦 完 毕 可 以 拍照 了 。 

takePicture: 开始 拍照 ,并 设置 拍照 相关 事件 .第 一 个 参数 为 快门 回调 接口 ShutterCallback， 
它 的 onShutter 方 法 在 按 下 快门 时 触发 ， 通 常 可 在 此 播放 拍照 声音 ， 默 认为 “ 叶 喀 ”一 声 ; 
第 二 个 参数 的 PictureCallback 表示 原始 图 像 的 回调 接口 ， 通 常 无 须 处 理 直 接 传 null; 第 
三 个 参数 的 PictureCallback 表示 JPG 图 像 的 回调 接口 ， 压 缩 后 的 图 像 数 据 可 在 该 接口 中 
的 onPictureTaken 方法 中 获得 。 

setZoomChangeListener: 设置 缩放 比例 变化 事件 .缩放 变化 监听 器 OnZoomChangeListener 
的 onZoomChange 方法 在 缩放 比例 发 生变 化 时 触发 。 

setPreviewCallback: 设置 预览 回调 事件 ， 通 常 在 连 拍 时 调用 。 预 览 回调 接 口 
PreviewCallback 的 onPreviewFrame 方法 在 预览 图 像 发 生变 化 时 触发 。 





e@ stopPreview: 停止 预览 。 
e@ lock: 录像 完毕 对 摄像 头 加 锁 。 该 方法 在 stopPreview 方法 之 后 调用 。 
erelease: 释放 摄像 头 。 因 为 摄像 头 不 能 重复 打开 ， 所 以 每 次 退出 拍照 时 都 要 释放 摄像 头 。 


结合 使 用 相机 工具 与 表面 视图 可 以 实现 单 拍 〈 每 次 只 拍 一 张 照片 ) 与 连 拍 (自动 连续 拍 


摄 多 张 照片 ) 两 种 拍照 功能 。 其 中 ， 单 拍 功能 的 实现 代码 关键 片段 如 下 : 


private Camera mCamera; ”// 声明 一 个 相机 对 象 
private boolean isPreviewing = 包 lse; / 是 否 正在 预览 
private Point mCameraSize; / 相机 画面 的 尺寸 


public CameraView(Context context, AttributeSet attrs) { 
super(context, attrs); 
mContext = context; 
/ 获取 表面 视图 的 表面 持 有 者 
SurfaceHolder holder = getHolder(); 
/ 给 表面 持 有 者 添加 表面 变更 监听 器 
holder.addCallback(mSurfaceCallback); 
// 去 除 黑色 背景 。TRANSLUCENT 半 透 明 ; TRANSPARENT 透明 
holder.setFormat(PixelFormat.TRANSPARENT); 


// 执行 拍照 动作 。 外 部 调用 该 方法 完成 拍照 
public void doTakePictureO { 
if (isPreviewing && mCamera != nulD) { 
/ 命令 相机 拍摄 一 张 照片 
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mCamera.takePicture(mShutterCallback, null, mPictureCallback); 


private String mPhotoPath; / 照片 的 保存 路 径 
/ 获取 照片 的 保存 路 径 。 外 部 调用 该 方法 获得 相片 文件 的 路 径 
public String getPhotoPath() { 

return mPhotoPath; 


// 定义 一 个 快门 按 下 的 回调 监听 器 。 可 在 此 设置 类 似 播放 “ 味 咏 ” 声 之 类 的 操作 ， 默 认 就 是 咋 喀 。 
private ShutterCallback mShutterCallback =new ShutterCallback() { 

public void onShutterO 由 
相 


/ 定义 一 个 获得 拍照 结果 的 回调 监听 器 。 可 在 此 保存 图 片 
private PictureCallback mPictureCallback = new PictureCallback() { 
public void onPictureTaken(byte[] data, Camera camera) { 

Bitmap raw = null; 

if (null != data) { 
/ 原始 图 像 数 据 data 是 字 节 数组 ， 需 要 将 其 解析 成 位 图 
raw = BitmapFactory.decodeByteArray(data, 0, data.length); 
// 停止 预览 画面 
mCamera.stopPreview(); 
isPreviewing = false; 

b 

/ 旋转 位 图 

Bitmap bitmap = BitmapUtil.getRotateBitmap(raw, 

(mCameraType — CAMERA _ BEHIND)? 90 : -90); 
// 获取 本 次 拍摄 的 照片 保存 路 径 
mPhotoPath = String.format("%os%s.jpg", BitmapUtil.getCachePath(mContext), 
DateUtil.getNowDateTimeO); 

1/ 保存 照片 文件 

BitmapUtil.saveBitmap(mPhotoPath, bitmap, "jpg", 80); 

ty{ 
Thread.sleep(1000); // 保存 文件 需要 时 间 

} catch (InterruptedException e) { 
€.printStackTrace(); 

}; 

// 再 次 进入 预览 画面 

mCamera.startPreview(); 

isPreviewing = true; 
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// 预览 画面 状态 变更 时 的 回调 监听 器 
private SurfaceHolder.Callback mSurfaceCallback = new SurfaceHolder.Callback() { 
/ 在 表面 视图 创建 时 触发 
public void surfaceCreated(SurfaceHolder holder) { 

/ 打开 摄像 头 

mCamera = Camera.open(mCameraType); 

ty{ 
/ 设置 相机 的 预览 界面 
mCamera.setPreviewDisplay(holder); 
// 获得 相机 画面 的 尺寸 
mCameraSize = CameraUtil.getCameraSize(mCamera.getParameters(), 

CameraUtil.getSize(mContext)); 
// 获取 相机 的 参数 信息 
Camera.Parameters parameters = mCamera.getParameters(); 
/ 设置 预览 界面 的 尺寸 
parameters.setPreviewSize(mCameraSize.x, mCameraSize.y); 
/ 设置 图 片 的 分 辩 率 
parameters.setPictureSize(mCameraSize.x, mCameraSize.y); 
/ 设置 图 片 的 格式 
parameters.setPictureFormat(ImageFormat.JPEG); 
// 设置 对 焦 模式 为 自动 对 焦 。 前 置 摄像 头 似乎 无 法 自动 对 焦 
if (mCameraType 一 CameraView.CAMERA_ BEHIND) { 
parameters.setFocusMode(Camera.Parameters.FOCUS MODE AUTO); 

! 
/ 设置 相机 的 参数 信息 
mCamera.setParameters(parameters); 

} catch (Exception e) { 
€.printStackTrace(); 
mCamera.release(); // 遇 到 异常 要 释放 相机 资源 


mCamera = null; 


} 


/ 在 表面 视图 变更 时 触发 
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { 
1/ 设置 相机 的 展示 角度 
mCamera.setDisplayOrientation(90); 
// 开始 预览 画面 
mCamera.startPreview(); 
isPreviewing = true; 


/ 开始 自动 对 焦 


第 9 章 设备 操作 


341 





mCamera.autoFocus(nulD); 
/ 设置 相机 的 预览 监听 器 。 注 意 这 里 的 setPreviewCallback 给 连 拍 功能 使 用 
mCamera.setPreviewCallback(mPreviewCallback); 

b 


/ 在 表面 视图 销毁 时 触发 
public void surfaceDestroyed(SurfaceHolder holder) { 
// 将 预览 监听 器 置 空 
mCamera.setPreviewCallback(null); 
// 停止 预览 画面 
mCamera.stopPreview(); 
/ 释放 相机 资源 
mCamera.release(); 
mCamera = null; 
} 
bs 
单 拍 的 效果 如 图 9-5 所 示 ， 每 次 从 拍照 页 面 返回 时 都 展示 最 后 一 张 拍摄 的 照片 。 


Camera 拍 照 





后 置 摄像 头 拍 昭 前 置 摄像 头 拍照 后 置 摄像 头 拍照 前 置 摄像 头 拍 照 











图 9-5 使 用 Camera 单 拍 的 效果 图 图 9-6 使 用 Camera 连 拍 的 效果 图 





实现 连 拍 功 能 要 先 调用 setPreviewCallback 方法 设置 预览 回调 接口 ， 然 后 实现 回调 接口 中 
的 onPreviewFrame 方法 ， 在 该 方法 中 获得 并 保存 每 张 预览 照片 。 连 拍 功能 的 实现 代码 如 下 : 


private boolean isShooting = 包 lse; // 是 否 正在 连 拍 
private int shooting num = 0; / 已 经 拍摄 的 相片 数量 
private ArrayList<String> mShootingArray; / 连 拍 的 相片 保存 路 径 队 列 


/ 获取 连 拍 的 相片 保存 路 径 队 列 。 外 部 调用 该 方法 获得 连 拍 结果 相片 的 路 径 队 列 
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public ArrayList<String> getShootingList() { 
return mShootingArray; 


// 执行 连 拍 动作 。 外 部 调用 该 方法 完成 连 拍 
public void doTakeShooting() { 
mShootingArray = new ArrayList<String>(); 
isShooting = true; 
shooting num = 0; 


// 定义 一 个 画面 预览 的 回调 监听 器 。 在 此 可 捕获 动态 的 连续 图 片 
private PreviewCallback mPreviewCallback = new PreviewCallback() { 
(QOverride 
public void onPreviewFrame(byte[] data, Camera camera) { 

if (lisShooting) { 
return; 

} 

// 获取 相机 的 参数 信息 

Camera.Parameters parameters = camera.getParameters(); 

/ 获得 预览 数据 的 格式 

int imageFormat = parameters.getPreviewFormat(); 

int width = parameters.getPreviewSize().width; 

int height = parameters.getPreviewSize().height; 

Rect rect = new Rect(0, 0, width, heigh?t); 

// 创建 一 个 YUV 格式 的 图 像 对 象 

YuvImage yuvImg = new YuvImage(data, imageFormat width, height, null); 

ty{ 
ByteArrayOutputStream bos =new ByteArrayOutputStream(); 
yuvImg.compressToJpeg(rect, 80, bos); 
// 从 字 节 数组 中 解析 出 位 图 数据 
Bitmap raw = BitmapFactory.decodeByteArray( 

bos.toByteArray(), 0, bos.size0); 
/ 旋转 位 图 
Bitmap bitmap = BitmapUtil.getRotateBitmap(raw, 
(mCameraType 一 CAMERA_BEHIND) ? 90 : -90); 

/ 获取 本 次 拍摄 的 照片 保存 路 径 


String path = String.format("%s%s.jpg", BitmapUtil.getCachePath(mContext), 


DateUtil.getNowDateTimeFull()); 
/ 把 位 图 保存 为 图 片 文件 
BitmapUtil.saveBitmap(path, bitmap, "jpg", 80); 
// 再 次 进入 预览 画面 
camera.startPreview(); 


第 9 章 设备 操作 | 343 





Shooting_num++; 
mShootingArray.add(path); 
让 (shooting num > 8) { // 每 次 连 拍 9 张 
isShooting = false; 
Toast.makeText(mContext, "已 完成 连 拍 ", Toast.LENGTH_SHORT).show0; 
} catch (Exception e) { 
€.printStackTrace(); 
} 


如 
连 拍 的 效果 如 图 9-6 所 示 ， 每 次 从 拍照 页 面 返回 时 都 展示 最 后 一 组 连 拍 的 照片 合集 。 
9.1.3 ”纹理 视图 TextureView 


表面 视图 SurfaceView 在 一 般 情 况 下 足够 使 用 了 ， 但 是 有 一 些 限制 。 因 为 表面 视图 不 是 通 
过 onDraw 方法 和 dispatchDraw 方法 进行 绘图 ， 所 以 无 法 使 用 View 的 基本 视图 方法 。 例 如 ， 
各 种 视图 变化 方法 均 无 法 奏效 ， 包 括 透 明度 变化 方法 setAlpha、 平 移 方法 setTranslation 、 缩 放 
方法 setScale、 旋 转 方 法 setRotation 等 ， 甚 至 连 最 基础 的 背景 图 设置 方法 setBackground 都 失 
效 了 。 

为 了 解决 表面 视图 的 不 足 之 处 ，Android 在 4.0 之 后 引入 了 纹理 视图 TextureView。 与 表面 
视图 相 比 , 纹理 视图 并 没有 创建 一 个 单独 的 绘图 表面 用 来 绘制 , 可 以 像 普通 视图 一 样 执行 变换 
操作 ， 也 可 以 正常 设置 背景 图 。 

下 面 是 TextureView 的 常用 方法 。 

e@ lockCanvas: 锁定 并 获取 画布 。 

e@ unlockCanvasAndPost: 解锁 并 刷新 画布 。 

e@ setSurfaceTextureListener: 设置 表面 纹理 的 监听 器 。 该 方法 相当 于 SurfaceHolder 的 


addCallback 方法 , 用 来 监控 表面 纹理 的 状态 变化 事件 .方法 参数 为 SurfaceTextureListener 
监听 器 对 象 ， 需 重 写 以 下 4 个 方法 。 


> onSurfaceTextureAvailable: 在 表面 纹理 可 用 时 触发 ， 可 在 此 进行 打开 相机 等 操作 。 
> onSurfaceTextureSizeChanged: 在 表面 纹理 尺寸 变化 时 触发 。 

> onSurfaceTextureDestroyed: 在 表面 纹理 销毁 时 触发 。 

> onSurfaceTextureUpdated: 在 表面 纹理 更 新 时 触发 。 


。 isAvailable: 判断 表面 纹理 是 否 可 用 。 
e@ getSurfaceTexture: 获取 表面 纹理 。 


下 面 通过 具体 例子 说 明 纹理 视图 与 表面 视图 的 区 别 。 图 9-7 所 示 为 纹理 视图 的 透明 度 值 为 
0.2, 扇形 看 起 来 颜色 较 浅 ; 图 9-8 所 示 为 纹理 视图 的 透明 值 增 大 为 0.8, 此 时 扇形 的 颜色 较 深 。 
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图 9-7 透明 度 为 0.2 的 纹理 视图 图 9-8 透明 度 为 0.8 的 纹理 视图 


纹理 视图 和 表面 视图 的 默认 背景 都 是 黑色 ， 要 想 把 背景 改 为 白色 ，TextureView 可 以 直接 
调用 背景 设置 方法 setBackground， 而 SurfaceView 要 调用 以 下 代码 才能 把 背景 洗 白 : 
// 下 面 两 行 设置 背景 为 透明 ， 因 为 SurfaceView 默认 背景 是 黑色 


setZOrderOnTop(true); 
mHolder.setFormat(PixelFormat.TRANSLUCENT); 


9.1.4 使 用 Camera 2 拍照 


如 同 纹理 视图 是 表面 视图 的 升级 版 那样 , Android 在 5.0 之 后 推出 了 Camera 的 升级 版 一 一 
Camera 2。 按 照 Android 的 官方 说 明 ，Camera 2 支持 以 下 5 点 新 特性 : 
(1) 支持 每 秒 30 帧 的 全 高 清 连 拍 。 
(2) 支持 在 每 帧 之 间 使 用 不 同 的 设置 。 
(3) 支持 原生 格式 的 图 像 输出 。 
(4) 支持 零 延迟 快门 和 电影 速 拍 。 
(5) 支持 相机 在 其 他 方面 的 手动 控制 ， 比 如 设置 噪音 消除 的 级 别 。 
Camera2 在 架构 上 做 了 大 幅 改 造 ， 原 先 的 Camera 类 被 拆 分 为 多 个 管理 类 ， 主 要 有 相机 管 
理 器 CameraManager、 相 机 设备 CameraDevice、 相 机 拍照 会 话 CameraCaptureSession、 图 像 读 
取 器 ImageReader。 


1. 相机 管理 器 CameraManager 

相机 管理 器 用 于 获取 可 用 摄像 头 列表 、 打 开 摄 像 头等 ,对 象 从 系统 服务 CAMERA_SERVICE 
获取 。 常 用 方法 说 明 如 下 。 

e getCameraldList: 获取 相机 列表 。 通 常 返回 两 条 记录 ， 一 条 是 后 置 摄 像 头 ， 另 一 条 是 前 


置 摄像 头 。 
egetCameraCharacteristics: 获取 相机 的 参数 信息 。 包 括 相 机 的 支持 级 别 、 照 片 的 尺寸 等 。 


因为 Camera2 是 Android 5.0 之 后 才 有 的 新 特性 ， 不 少 手机 还 不 能 很 好 地 支持 ， 所 以 最 好 
先 检查 相机 的 支持 级 别 , 如 果 返 回 值 为 INFO_SUPPORTED_HARDWARE LEVEL_ LEGACY， 
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就 不 建议 在 App 中 使 用 Camera2 的 相关 技术 。 检 查 相 机 支持 级 别 的 代码 如 下 : 


2; 


// 从 系统 服务 中 获取 相机 管理 器 

CameraManager cm = (CameraManager) mContext.getSystemService(Context.CAMERA SERVICE); 
/ 获取 可 用 相机 设备 列表 

CameraCharacteristics cc = cm.getCameraCharacteristics(cameraid); 

/ 检查 相机 硬件 的 支持 级 别 
/CameraCharacteristicsJNFO_SUPPORTED HARDWARE LEVEL FULL 表示 完全 支持 
/CameraCharacteristicsJNFO_SUPPORTED HARDWARE LEVEL _LIMITED 表示 有 限 支持 
/CameraCharacteristicsJNFO_SUPPORTED_ HARDWARE _ LEVEL LEGACY 表示 遗留 的 

int level = cc.get(CameraCharacteristics.INFO_SUPPORTED HARDWARE LEVEL); 


openCamera: 打开 指定 摄像 头 ， 第 一 个 参数 为 指定 摄像 头 的 id， 第 二 个 参数 为 设备 状态 
监听 器 ， 该 监听 器 需 实现 接口 CameraDevice.StateCallback 的 onOpened 方法 (方法 内 部 
再 调用 CameraDevice 对 象 的 createCaptureRequest 方法 ) 。 

setTorchMode: 在 不 打开 摄像 头 的 情况 下 ， 开 局 或 关闭 闪光 灯 。 为 true 表示 开启 闪光 灯 ， 
为 false 表示 关闭 闪光 灯 。 

相机 设备 CameraDevice 


相机 设备 用 于 创建 拍照 请 求 、 添 加 预览 界面 、 创 建 拍照 会 话 等 。 常 用 方法 说 明 如 下 。 


3. 


createCaptureRequest: 创建 拍照 请 求 ， 第 二 个 参数 为 会 话 状态 的 监听 器 ， 该 监听 器 需 实 
现 会 话 状态 回调 接口 CameraCaptureSession.StateCallback 的 onConfigured 方法 (方法 内 
部 再 调用 CameraCaptureSession 对 象 的 setRepeatingRequest 方法 ， 将 预览 影像 输出 到 屏 
幕 ) 。createCaptureRequest 方法 返回 一 个 CaptureRequest 的 预览 对 象 。 

close: 关闭 相机 。 


相机 拍照 会 话 CameraCaptureSession 


相机 拍照 会 话 用 于 设置 单 拍 会 话 ( 每 次 只 拍 一 张 照片 》、 连 拍 会 话 〈 自动 连续 拍摄 多 张 
照片 ) 等 。 常 用 方法 说 明 如 下 。 

e@ ”getDevice: 获得 该 会 话 的 相机 设备 对 象 。 

e@ capture: 拍照 并 输出 到 指定 目标 。 输 出 目标 为 CaptureRequest 对 象 时 ， 表 示 显 示 在 屏幕 


4. 


上 ; 输出 目标 为 ImageReader 对 象 时 ， 表 示 要 保存 照片 。 

setRepeatingRequest: 设置 连 拍 请 求 并 输出 到 指定 目标 。 输 出 目标 为 CaptureRequest 对 象 
时 ， 表 示 显 示 在 屏幕 上 ; 输出 目标 为 ImageReader 对 象 时 ， 表 示 要 保存 照片 。 
stopRepeating: 停止 连 拍 。 


图 像 读 取 器 ImageReader 


图 像 读 取 器 用 于 获取 并 保存 照片 信息 ， 一 旦 有 图 像 数 据 生成 ， 立 刻 触 发 onImageAvailable 
方法 。 常 用 方法 说 明 如 下 。 


getSurface: 获得 图 像 读 取 的 表面 对 象 。 
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e setOnImageAvailableListener: 设置 图 像 数据 的 可 用 监听 器 。 该 监听 器 需 实现 接口 
ImageReader.OnImageAvailableListener 的 onImageAvailable 方法 。 
这 几 个 相机 类 之 间 的 调用 流程 比 原来 的 Camera 类 要 复杂 许多 ， 大 致 的 处 理 流转 为 : 


TextureView 一 SurfaceTextureListener 一 CameraManager 一 StateCallback 一 CameraDevice 一 





CaptureRequestBuilder 一 CameraCaptureSession 一 ImageReader 一 OnImageAvailableListener 一 
Bitmap。 其 间 的 逻辑 关系 颇 为 复杂 ， 详 细 的 文字 说 明 反 而 不 容易 理解 ， 限 于 篇 幅 这 里 就 不 贴 出 
大 段 的 调用 代码 了 ， 读 者 可 翻阅 本 书 附带 源码 device 模块 里 面 的 Camera2View.java， 一 边 阅 
读 代码 、 一 边 熟 悉 调 用 流程 。 

使 用 Camera 2 拍照 的 效果 如 图 9-9 和 图 9-10 所 示 。 其 中 ， 如 图 9-9 所 示 为 单 拍 时 拍摄 的 
最 后 一 张 照片 ， 如 图 9-10 所 示 为 连 拍 时 拍摄 的 最 后 一 组 照片 合集 。 


device device 





新 版 Ccamera2 拍 照 新 版 camera2 拍 照 


| 
1 I 
必 


后 车 摄 像 头 拍照 前 党 提 像 头 拍照 后 置 摄像 头 拍照 前 置 摄像 头 拍照 





图 9-9 使 用 Camera 2 单 拍 的 效果 图 图 9-10 使 用 Camera 2 连 拍 的 效果 图 
9.1.5 ”运行 时 动态 授权 管理 


App 开发 过 程 中 ， 涉 及 到 硬件 设备 的 操作 ， 比 如 拍照 、 录 音 、 定 位 、SD 卡 等 ， 都 要 在 
AndroidManifest.xml 中 声明 相关 的 权限 。 可 是 Android 系统 为 了 防止 某 些 App 滥用 权限 , 又 允 
许 用 户 在 系统 设置 里 面 对 App 禁用 某 些 权限 。 然 而 这 又 带 来 男 一 个 问题 , 用 户 打开 App 之 后 ， 
App 可 能 因为 权限 不 足 导致 无 法 正常 运行 ， 甚 至 直接 骨 溃 内 退 。 遇 到 这 种 情况 ,只 需 用 户 在 系 
统 设置 中 开启 相关 权限 即 可 恢复 正常 , 但 是 用 户 并 非 专业 的 开发 者 , 他 怎 知 要 去 启用 哪些 权限 
呢 ? 再 说 ， 每 次 都 要 用 户 亲 自打 开 系统 设置 页 面 ， 再 琢磨 半天 精 挑 细 选 那些 必须 开启 的 权限 ， 
不 但 劳力 而 且 劳 神 ， 这 种 用 户 体验 实在 差劲 。 

有 鉴于 此 ，Android 从 6.0 开始 引入 了 运行 时 权限 管理 机 制 ， 允 许 App 在 运行 过 程 中 动态 
检查 是 否 拥有 某 项 权限 , 一 旦 发 现 缺少 某 种 必需 的 权限 , 则 系统 会 自动 弹出 小 窗 提示 用 户 去 
启 该 权限 。 如 此 这 般 ， 一 方面 开发 者 无 需 担 心 App 因 权 限 不 足 而 内 退 的 问题 ， 另 一 方面 用 户 
也 不 再 头痛 是 哪个 权限 被 禁止 导致 App 用 不 了 的 毛病 ， 这 个 贴心 的 动态 权限 授权 功能 可 谓 是 
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皆大欢喜 。 下 面 就 来 看 看 如 何在 代码 中 实现 运行 时 权限 管理 机 制 。 

首先 要 检查 Android 系统 是 否 为 6.0 及 以 上 版 本 ， 因 为 运行 时 权限 管理 机 制 是 6.0 才 开 始 
支持 的 功能 。 其 次 调用 ContextCompat.checkSelfPermission 方法 ,检查 当前 App 是 否 开 启 了 指 
定 的 权限 。 倘 车 检 查 结果 是 尚未 开启 权限 ， 则 再 调用 ActivityCompat.requestPermissions 方法 ， 
请 求 系统 弹出 开启 权限 的 确认 对 话 框 。 详 细 的 权限 校 验 代码 如 下 所 示 : 


// 检查 某 个 权限 。 返 回 tmue 表示 已 启用 该 权限 ， 返 回 false 表示 未 启用 该 权限 
public static boolean checkPermission(Activity act, String permission, int requestCode) { 
boolean result = true; 
// 只 对 Android 6.0 及 以 上 系统 进行 校 验 
if (Build.VERSION.SDK_INT >= Build.VERSION CODES.M) { 
// 检查 当前 App 是 否 开启 了 名 称 为 permission 的 权限 
int check = ContextCompat.checkSelfPermission(act, permission); 
if (check != PackageManager.PERMISSION_GRANTED) { 
// 未 开启 该 权限 ， 则 请 求 系统 弹 窗 ， 好 让 用 户 选 择 是 否 立即 开启 权限 
ActivityCompat.requestPermissions(act, new String[] {permission}, requestCode); 
result = false; 
} 
} 
return result; 


比如 App 现在 准备 拍照 ， 就 要 检查 是 否 开 启 了 相机 权限 Manifest.permission.CAMERA， 
如 果 没 有 启用 相机 权限 ， 则 系统 会 弹出 如 图 9-11 所 示 的 选择 窗口 。 再 比如 App 准备 获取 手机 
的 位 置信 息 ， 就 要 检查 是 否 开启 了 定位 权限 Manifestpermission.ACCESS_FINE_LOCATION， 
如 果 没 有 启用 定位 ， 则 系统 会 弹出 如 图 9-12 所 示 的 选择 窗口 。 


A A 


要 允许 device 通过 网 络 或 者 卫星 对 您 的 手 
要 允许 device 拍摄 照片 和 录制 视频 吗 ? 机 定位 吗 ? 





图 9-11 相机 权限 的 请 求 弹 窗 图 9-12 定位 权限 的 请 求 弹 窗 
注意 到 系统 的 权限 选择 弹 窗 存在 “拒绝 ”和 “人 允许 ”两 个 按钮 ， 这 便 意味 着 开发 者 要 对 
两 种 选项 分 别 进行 处 理 。 如 果 用 户 点 击 “ 拒 绝 ” 按 钮 ， 自 然 表 示 接 下 来 App 将 会 无 法 正常 运 
行 ， 此 时 需要 提示 用 户 可 能 产生 的 问题 及 其 原因 ; 如 果 用 户 点 击 “ 人 允许” 按钮 ， 系 统 会 立即 给 
App 赋予 相应 的 权限 ， 那 么 App 就 按照 正常 的 流程 走 下 去 ， 该 拍照 就 拍照 、 该 定位 就 定位 。 
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以 上 选项 判断 的 逻辑 ， 具 体 到 代码 中 则 需 重 写 Activity 的 onRequestPermissionsResult 函数 ， 
写 后 的 函数 代码 示例 如 下 : 


| 
旺 





public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) { 
让 (requestCode 一 mRequestCode) { // 通过 requestCode 区 分 不 同 的 请 求 
让 (grantResults[0] == PackageManagerPERMISSION_ GRANTED) { 
/ 已 授权 ， 则 进行 后 续 的 正常 逻辑 处 理 
}else{ 
// 未 授权 ， 则 提示 用 户 可 能 导致 的 问题 
} 


} 


有 时 某 种 业务 必须 同时 开启 多 项 权限 ， 辟 如 录像 就 得 既 开 启 相机 权限 、 又 开启 录音 权限 。 
那么 在 校 验 权限 的 时 候 ， 要 多 次 调用 ContextCompat.checkSelfPermission 方法 ， 只 有 待 检查 的 
所 有 权限 都 已 经 授权 , 才 无 需 系统 弹 窗 提示 ; 否则 的 话 , 仍 需 系统 逐个 弹 窗 以 供用 户 选择 确认 。 
下 面 是 同时 校 验 多 个 权限 的 代码 例子 ， 其 中 多 个 权限 以 字符 串 数组 的 参数 形式 传 入 “new 
String[] {Manifest.permission.RECORD_AUDIO, Manifest.permission.CAMERA}” : 


/ 检查 多 个 权限 。 返 回 true 表示 已 完全 启用 权限 ， 返 回 false 表示 未 完全 启用 权限 
public static boolean check MultiPermission(Activity acb String[] permissions, int requestCode) { 
boolean result = true; 
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) { 
int check = PackageManager PERMISSION_GRANTED; 
for (String permission : permissions) { / 通过 权限 数组 检查 是 否 都 开启 了 这 些 权限 
check = ContextCompat.checkSelfPermission(act, permission); 
if (check != PackageManagerPERMISSION_GRANTED) { 
break:; 
} 
上 
if (check != PackageManager.PERMISSION_GRANTED) { 
/ 未 开启 该 权限 ， 则 请 求 系统 弹 窗 ， 好 让 用 户 选 择 是 否 立即 开启 权限 
ActivityCompat.requestPermissions(act, permissions, requestCode); 
result = false; 
} 
} 
return result; 


仍 以 录像 业务 为 例 ， 假 如 之 前 App 既 无 相机 权限 也 无 录音 权限 ， 则 引入 运行 时 权限 管理 
机 制 之 后 ， 系 统 会 在 界面 上 依次 弹出 录音 权限 选择 窗 、 相 机 权限 选择 窗 。 两 个 弹 窗 的 界面 如 图 
9-13 和 图 9-14 所 示 。 其 中 图 9-13 为 先 弹出 的 录音 选择 窗 ， 图 9-14 为 后 弹出 的 相机 选择 窗 。 





A 


要 允许 device 录制 音频 吗 ? 要 允许 device 拍摄 照片 和 录制 视频 吗 ? 


第 1 项 权限 ( 共 2 项) 第 2 项 权限 ( 共 2 项 ) 





图 9-13 先 弹 出 来 的 录音 权限 选择 窗 图 9-14 后 弹出 来 的 相机 权限 选择 窗 


9.2 麦克 风 


本 节 介 绍 以 麦克 风 为 基础 的 声效 应 用 , 首先 简要 说 明 拖 动 条 SeekBar 的 用 法 , 描述 如 何 使 
用 拖 动 条 调整 各 类 音量 大 小 ; 然后 介绍 媒体 录制 器 MediaRecorder 与 媒体 播放 器 MediaPlayer， 
并 演示 通过 媒体 录制 器 和 媒体 播放 器 完成 录音 和 播音 功能 ; 最 后 结合 9.1 节 的 相机 与 表面 视图 
知识 演示 通过 媒体 录制 器 和 媒体 播放 器 完成 录像 和 放映 功能 。 


9.2.1 拖 动 条 SeekBar 


拖 动 条 SeekBar 继承 自 进 度 条 ProcessBar， 与 进度 条 的 不 同 之 处 在 于 : 进度 条 只 能 在 代码 
中 修改 进度 ， 不 能 由 用 户 改变 进度 值 ; 拖 动 条 不 但 可 以 在 代码 中 修改 进度 , 还 可 以 由 用 户 在 屏 
幕 上 通过 拖 动 操作 改变 进度 。 拖 动 条 可 用 于 音频 和 视频 播放 时 的 进度 条 , 用 户 通过 拖 动 操 作 控 
制 播放 器 快 进 或 快 退 到 指定 位 置 ， 然 后 从 新 位 置 开 始 播放 音频 或 视频 。 除 此 之 外 , 拖 动 条 还 可 
调节 各 种 音量 大 小 、 调 节 屏 幕 亮度 、 调 节 字 体 大 小 等 。 

下 面 是 SeekBar 新 增加 的 4 个 方法 。 


setThumb: 设置 当前 进度 位 置 的 图 标 。 

setThumbOffset: 设置 当前 进度 图 标的 偏 移 量 。 

setKeyProgressIncrement: 设置 使 用 方向 键 更 改进 度 时 每 次 的 增加 值 。 

setOnSeekBarChangeListener: 设置 拖 动 变化 事件 。 需 实现 监听 器 OnSeekBarChangeListener 

的 3 个 方法 。 

> onProgressChanged: 在 进度 变化 时 触发 。 第 3 个 参数 表示 是 否 来 自用 户 , 为 true 表示 用 户 
拖 动 ， 为 false 表示 代码 修改 进度 。 

> onStartTrackingTouch: 开始 拖 动 时 触发 。 

> onStopTrackingTouch: 结束 拖 动 时 触发 。 一 般 在 该 方法 中 添加 用 户 拖 动 的 处 理 远 辑 。 


下 面 是 操作 拖 动 条 的 代码 : 
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public class SeekbarActivity extends AppCompatActivity implements OnSeekBarChangeListener { 
private TextView tv_progress; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_seekbar); 
tv_progress = findViewById(R.id.tv_progress); 
/ 从 布局 文件 中 获取 名 叫 sb_progress 的 拖 动 条 
SeekBar sb progress = findViewById(R.id.sb_progress); 
// 给 sb_progress 设置 拖 动 变更 监听 器 
sb_progress.setOnSeekBarChangeListener(this); 
/ 设置 拖 动 条 的 当前 进度 
sb_progress.setProgress(50); 

b 


// 在 进度 变更 时 触发 。 第 三 个 参数 为 true 表示 用 户 拖 动 ， 为 false 表示 代码 设置 进度 

public void onProgressChanged(SeekBar seekBar int progress, boolean fromUser) { 
String desc = "当前 进度 为 : "+ seekBar.getProgress() + "， 最 大 进度 为 " + seekBar.getMax(); 
tv_progress.SetText(desc); 


/ 在 开始 拖 动 进度 时 触发 
public void onStartTrackingTouch(SeekBar seekBar) {} 


// 在 停止 拖 动 进度 时 触发 
public void onStopTrackingTouch(SeekBar seekBar) {} 


} 
上 述 代 码 的 界面 效果 如 图 9-15 和 图 9-16 所 示 。 其 中 ， 如 图 9-15 所 示 为 拖 动 前 的 界面 ， 
进度 值 为 50; 如 图 9-16 所 示 为 向 右 拖 动 后 的 界面 ， 进 度 值 为 73。 











一 一 © 
当前 进度 为 ; 50, 最 大 进度 为 100 当前 进度 为 : 73, 最 大 进度 为 100 
图 9-15 拖 动 前 的 SeekBar 图 9-16 拖 动 后 的 SeekBar 


9.2.2 ”音量 控制 


Android 只 有 一 个 麦克 风 ， 却 有 6 类 铃 音 ， 分 别 是 通话 音 、 系 统 音 、 铃 音 、 媒 体 音 、 曾 钟 
音 、 通 知音 ， 铃 音 类 型 的 取 值 说 明 见 表 9-2。 
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表 9-2 铃 音 类 型 的 取 值 说 明 
AudioManager 类 的 铃 音 类 型 
STREAM VOICE CALL 
STREAM SYSTEM 
STREAM_RING 
STREAM_MUSIC 
STREAM ALARM 
STREAM_ NOTIFICATION 


说 明 











来 电 与 收 短信 的 铃声 
音频 、 视 频 、 游 戏 等 的 声音 














管理 这 些 铃 声音 量 的 工具 是 AudioManager， 对 象 从 系统 服务 AUDIO_SERVICE 中 获取 。 
下 面 是 AudioManager 的 常用 方法 。 


getStreamMaxVolume: 获取 指定 类 型 铃声 的 最 大 音量 。 
getStreamVolume: 获取 指定 类 型 铃声 的 当前 音量 。 
getRingerMode: 获取 指定 类 型 铃声 的 响 铃 模式 。 响 铃 模式 的 取 值 说 明 见 表 9-3。 


表 9-3” 响 铃 模式 的 取 值 说 明 
AudioManager 类 的 响 铃 模式 说 明 
RINGER_MODE NORMAL 正常 
RINGER_MODE _SILENT 静音 
RINGER_MODE_VIBRATE 震动 











setStreamVolume: 设置 指定 类 型 铃声 的 当前 音量 。 

setRingerMode: 设置 指定 类 型 铃声 的 响 铃 模式 。 响 铃 模式 的 取 值 说 明 见 表 9-3。 
adjustStreamVolume: 调整 指定 类 型 铃声 的 当前 音量 。 第 一 个 参数 是 铃声 类 型 ; 第 二 个 参 
数 是 调整 方向 ， 音 量 调整 方向 的 取 值 说 明 见 表 9-4; 第 三 个 参数 表示 调整 时 的 附加 动作 ， 
一 般 使 用 FLAG_PLAY_SOUND 表示 调整 时 提示 一 个 铃声 。 


表 9-4 音量 调整 方向 的 取 值 说 明 














AudioManager 类 的 音量 调整 方向 说 明 
ADJUST_RAISE 调 大 一 级 
ADJUST_LOWER 调 小 一 级 
ADJUST_SAME 保持 不 变 
ADJUST MUTE 静音 
ADJUST_UNMUTE 取消 静音 





ADJUST_TOGGLE MUTE 静音 取 反 ， 即 原来 不 是 静音 就 设置 静音 ， 原 来 是 静音 就 取消 静音 





上 面 的 setStreamVolume 和 adjustStreamVolume 两 个 方法 都 能 用 来 设置 音量 ， 不 同 的 是 
setStreamVolume 直接 将 音量 调整 到 目标 值 ， 通 常 与 拖 动 条 配合 使 用 ; 而 adjustStreamVolume 
是 以 当前 音量 为 基础 ， 然 后 调 大 、 调 小 或 调 静音 。 

音量 调整 的 效果 如 图 9-17 所 示 ， 这 个 设置 页 面 不 但 允许 直接 调整 音量 到 目标 值 ， 还 允许 
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逐 级 调 大 或 逐 级 调 小 音量 。 
device 
调节 通话 音量 
一 


调节 系统 音量 
人 


调节 铃声 音量 
i 


调节 音乐 音量 
一 一 全 


调节 阅 钟 音量 





调节 通知 音量 
ai 





图 9-17 各 种 铃 音 的 音量 调整 界面 
9.2.3 ”录音 与 播音 


Android 中 没有 单独 操作 麦克 风 的 工具 类 ， 如 果 要 录音 就 用 媒体 录制 器 MediaRecorder， 
如 果 要 播音 就 用 媒体 播放 器 MediaPlayer 类 。 下 面 分 别 进行 介绍 。 


1. 媒体 录制 器 MediaRecorder 


MediaRecorder 是 Android 自 带 的 音频 和 视频 录制 工具 ， 它 通过 操纵 摄像 头 和 麦克 风 完 成 
媒体 录制 ， 既 可 录制 视频 ， 又 可 单独 录制 音频 。 
下 面 是 MediaRecorder 的 常用 方法 (录音 与 录像 通用 〉。 


reset: 重 置 录制 资源 。 

prepare: 准备 录制 。 

start: 开始 录制 。 

stop: 结束 录制 。 

release: 释放 录制 资源 。 

setOnErrorListener: 设置 错误 监听 器 。 可 监听 服务 器 异常 和 未 知 错误 的 事件 。 需 要 实现 

接口 MediaRecorder.OnErrorListener 的 onError 方法 。 

esetOnInfoListener: 设置 信息 监听 器 。 可 监听 录制 结束 事件 ， 包 括 达 到 录制 时 长 或 达到 录 
制 大 小 。 需 要 实现 接口 MediaRecorder.OnInfoListener 的 onInfo 方法 。 

e@ setMaxDuration: 设置 可 录制 的 最 大 时 长 ， 单 位 毫秒 。 

esetMaxFileSize: 设置 可 录制 的 最 大 文件 大 小 ， 单 位 字 节 。 

e@ setOutputFile: 设置 输出 文件 的 路 径 。 


下 面 是 MediaRecorder 用 于 音频 录制 的 方法 〈 当 然 录 像 时 要 一 起 录音 ) 。 
e@ setAudioSource: 设置 音频 来 源 。 一 般 使 用 麦克 风 AudioSource.MIC。 
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e setOutputFormat: 设置 媒体 输出 格式 。 媒 体 输出 格式 的 取 值 说 明 见 表 9-5。 
表 9-5 媒体 输出 格式 的 取 值 说 明 

















OutputFormat 类 的 输出 格式 格式 说 明 

AMR NB 窜 带 格式 

AMR_ WB 宽带 格式 

AAC ADTS 高 级 的 音频 传输 流 格式 
MPEG 4 MPEG4 格式 

THREE _GPP 3GP 格式 





e@ setAudioEncoder: 设置 音频 编码 器 。 音 频 编码 器 的 取 值 说 明 见 表 9-6。 注 意 : 该 方法 应 在 
setOutputFormat 方法 之 后 执行 ， 否则 会 出 现 setAudioEncoder called in an invalid state(2) 的 











异常 。 
表 9-6 ”音频 编码 器 的 取 值 说 阴 

AudioEncoder 类 的 音频 编码 器 说 明 
AMR_NB 罕 带 编码 
AMR_WB 宽带 编码 
AAC 低 复杂 度 的 高 级 编码 
HE_AAC 高 效率 的 高 级 编码 
AAC ELD 高 效率 的 高 级 编码 





e setAudioSamplingRate: 设置 音频 的 采样 率 ， 单 位 千 赫兹 (kHz) 。AMR_NB 格式 默认 
8kHz，AMR_WB 格式 默认 16kHz。 
@ ”setAudioChannels: 设置 音频 的 声 道 数 。1 表示 单 声 道 ，2 表示 双 声 道 。 
esetAudioEncodingBitRate: 设置 音频 每 秒 录制 的 字 节 数 。 数 值 越 大 音频 越 清晰 。 
下 面 是 使 用 MediaRecorder 实现 简单 音频 录制 器 的 代码 : 
public class AudioRecorder extends LinearLayout implements OnErrorListener, 
OnlInfoListener, OnCheckedChangeListener { 
private Context mContext; // 声明 一 个 上 下 文 对 象 
private MediaRecorder mMediaRecorder;，// 声明 一 个 媒体 录制 器 对 象 
private ProgressBar pb_record; // 声明 一 个 进度 条 对 象 
private CheckBox ck_record; 
private Timer mTimer; / 计时 器 
private int mRecordMaxTime = 10; / 一 次 录制 的 最 长 时 间 
private int mTimeCount; // 时 间 计 数 
private String mRecordFilePath; / 录制 文件 的 保存 路 径 


public AudioRecorder(Context context AttributeSet attrs) { 
super(context, attrs); 
mContext = context; 
/ 从 布局 文件 audio_recorderxml 生成 当前 的 布局 视图 
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LayoutInflater.from(context).inflate(R.layout.audio_recorder, this); 
// 从 布局 文件 中 获取 名 叫 pb_record 的 进度 条 
pb_record = findViewById(R.id.pb_record); 
/ 设置 进度 条 的 最 大 值 
pb_record.set Max(mRecordMaxTime); 
ck_record = findViewById(R.id.ck record); 
ck_record.setOnCheckedChangeListener(this); 
D 


/ 开始 录制 
public void start() { 
/ 获取 本 次 录制 的 媒体 文件 路 径 
mRecordFilePath = MediaUtil.getRecordFilePath(mContext, "RecordAudio", ".amr"); 
try{ 
initRecord0; / 初始 化 录制 操作 
mTimeCount =0; / 时 间 计 数 清 零 
mTimer = new Timer0; / 创建 一 个 计时 器 
// 计时 器 每 隔 一 秒 就 更 新 进度 条 上 的 录制 进度 
mTimer.schedule(new TimerTask() { 
public void run() { 
pb_record.setProgress(mTimeCount++); 
} 
}, 0, 1000); 
} catch (Exception e) { 
e.printStack Trace(); 
b 
b 


/ 停止 录制 
public void stop() { 
if (mOnRecordFinishListener != null) { 
mOnRecordFinishListener.onRecordFinish(); 
} 
Pb_record.setProgress(0); / 进度 条 归 零 
if (mTimer !=nulD) { 
mTimer.cancel(); / 取消 计时 器 
cancelRecord(0); / 取消 录制 操作 
} 


/ 获取 录制 好 的 媒体 文件 路 径 
public String getRecordFilePath() { 
return mRecordFilePath; 
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/ 初始 化 录制 操作 
private void initRecordO { 


mMediaRecorder= new MediaRecorder0; / 创建 一 个 媒体 录制 器 
mMediaRecorder.setOnErrorListener(this); / 设置 媒体 录制 器 的 错误 监听 器 
mMediaRecordersetOnInfoListenertthis); / 设置 媒体 录制 器 的 信息 监听 器 
mMediaRecordersetAudioSource(AudioSource.MIC); / 设置 音频 源 为 麦克 风 
ImMediaRecordersetOutputFormat(OutputFormat.AMR_NB); // 设置 媒体 的 输出 格式 
ImMediaRecordersetAudioEncoder(AudioEncoderAMR_NB); / 设置 媒体 的 音频 编码 器 
//mMediaRecorder.setAudioSamplingRate(8); / 设置 媒体 的 音频 采样 率 。 可 选 
/mMediaRecordersetAudioChannels(2); / 设置 媒体 的 音频 声 道 数 。 可 选 
/mMediaRecordersetAudioEncodingBitRate(1024); / 设置 音频 每 秒 录制 的 字 节 数 。 可 选 
mMediaRecorder.setMaxDuration(10 * 1000); / 设置 媒体 的 最 大 录制 时 长 
//mMediaRecorder.setMaxFileSize(1024*1024*10); / 设置 媒体 的 最 大 文件 大 小 
// setMaxFileSize 与 setMaxDuration 设置 其 一 即 可 
mMediaRecordersetOutputFile(mRecordFilePath); // 设置 媒体 文件 的 保存 路 径 
try{ 

mMediaRecorder.prepare(); / 媒体 录制 器 准备 就 绪 

mMediaRecorder.start(); / 媒体 录制 器 开始 录制 
} catch (Exception e) { 

e.printStackTrace(); 
} 


// 取消 录制 操作 


private void cancelRecord() { 


1 


if (mMediaRecorder != null) { 

mMediaRecorder.setOnErrorListener(null); / 错误 监听 器 置 空 
mMediaRecordersetPreviewDisplaynulD); / 预览 界面 置 空 
ty { 

mMediaRecorderstop(0); / 媒体 录制 器 停止 录制 
} catch (Exception e) { 

e.printStackTrace0; 
} 
mMediaRecorderrelease(); / 媒体 录制 器 释放 资源 
mMediaRecorder = null; 


private OnRecordFinishListener mOnRecordFinishListener; / 声明 一 个 录制 完成 监听 器 对 象 
/ 定义 一 个 录制 完成 监听 器 接口 
public interface OnRecordFinishListener { 
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Void onRecordFinish(); 
} 


1/ 设置 录制 完成 监听 器 
public void setOnRecordFinishListener(OnRecordFinishListener listener) { 
mOnRecordFinishListener = listener; 


b 


/ 在 录制 发 生 错误 时 触发 
public void onError(MediaRecorder mr, int what, int extra) { 
if (mr!=nul) { 
mrreset0; / 重 置 媒体 录制 器 


1 


// 在 录制 遇 到 状况 时 触发 
public void onInfo(MediaRecorder mr, int what int extra) { 
/ 录制 达到 最 大 时 长 ， 或 者 达到 文件 大 小 限制 ， 都 停止 录制 
if (what 一 MediaRecorder. MEDIA RECORDER INFO MAX DURATION REACHED 
|| what == MediaRecorder. MEDIA RECORDER INFO MAX FILESIZE REACHED){ 
ck_record.setChecked(false); 


public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (buttonView.getId() 一 R.id.ck_record) { 

让 (isChecked) { / 开始 录制 
ck_record.setText(" 停 止 录 制 "); 
start(); 

} else { // 停止 录制 
ck_record.setText(" 开 始 录制 "); 
stopO; 


bh 
另外 ， 注 意 录音 与 录像 需要 在 AndroidManifest.xml 中 添加 权限 (录制 操作 通常 会 保存 媒 
体 文件 ， 也 就 是 操作 SD 卡 ， 所 以 需要 加 上 SD 卡 的 读 写 权限 ) : 
<!-- 录像 /录音 --> 
<uses-permission android:name="android.permission.CAMERA" /> 
<uses-permission android:name="android.permission.RECORD VIDEO"> 
<uses-permission android:name="android.permission.RECORD AUDIO" /> 
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<!--SD 卡 -人 

<uses-permission android:name="android.permission. WRITE EXTERNAL _ STORAGE" /> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE" /> 
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_ FILESYSTEMS" /> 


2. 媒体 播放 器 MediaPlayer 


MediaPlayer 是 Android 自 带 的 音频 和 视频 播放 器 , 可 用 于 播放 MediaRecorder 录制 的 媒体 
文件 ， 包 括 表 9-5 所 示 的 文件 格式 ， 还 有 MP3、WAV、MID、0OGG 等 音频 文件 ， 以 及 MKV、 
MOV、AVI 等 视频 文件 。 

下 面 是 MediaPlayer 的 常用 方法 〈 播 音 与 放映 通用 ) 。 


ee 9。 


reset: 重 置 播放 器 。 

prepare: 准备 播放 。 

start: 开始 播放 。 

pause: 暂停 播放 。 

stop: 停止 播放 。 

setOnPreparedListener: 设置 准备 播放 监听 器 。 需 要 实现 接口 MediaPlayerOnPreparedListener 
的 onPrepared 方法 。 

setOnCompletionListener: 设置 结束 播放 监听 器 。 需 要 实现 接口 MediaPlayer.OnCompletion- 
Listener 的 onCompletion 方法 。 

setOnSeekCompleteListener: 设置 播放 拖 动 监听 器 。 需 要 实现 接口 MediaPlayer.OnSeek- 
CompleteListener 的 onSeekComplete 方法 。 


ecreate: 创建 指定 Uri 的 播放 器 。 


setDataSource: 设置 播放 数据 来 源 的 文件 路 径 。create 与 setDataSource 两 个 方法 只 需 调 
期 三 丰 

setVolume: 设置 音量 。 两 个 参数 分 别 是 左 声 道 和 右 声 道 的 音量 ， 取 值 在 0~1 之 间 。 
setAudioStreamType: 设置 音频 流 的 类 型 。 音 频 流 类 型 的 取 值 说 明 见 表 9-2。 

setLooping: 设置 是 否 循环 播放 。true 表示 循环 播放 ，false 表示 只 播放 一 次 。 

isPlaying: 判断 是 否 正在 播放 。 

seekTo: 拖 动 播放 进度 到 指定 位 置 。 该 方法 可 与 拖 动 条 SeekBar 配合 使 用 。 
getCurrentPosition: 获取 当前 播放 进度 所 在 的 位 置 。 

getDuration: 获取 播放 时 长 ， 单 位 毫秒 。 


下 面 是 使 用 MediaPlayer 实现 简单 音频 播放 器 的 代码 : 
public class AudioPlayer extends LinearLayout implements 


OnCompletionListener, OnCheckedChangeListener { 
private Context mContext; // 声明 一 个 上 下 文 对 象 
private MediaPlayer mMediaPlayer; // 声明 一 个 媒体 播放 器 对 象 
private ProgressBar pb_play; / 声明 一 个 进度 条 对 象 
private CheckBox ck_play; 
private Timer mTimer; // 计时 器 
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private String mAudioPath; / 音频 文件 的 路 径 
private boolean isFinished = true; / 是 否 播放 结束 


public AudioPlayer(Context context AttributeSet attrs) { 
super(context, attrs); 
/ 从 布局 文件 audio_playerxml 生成 当前 的 布局 视图 
LayoutInflater.from(context).inflate(R.layout.audio_player, this); 
// 从 布局 文件 中 获取 名 叫 pb_play 的 进度 条 
pb_play= findViewById(R.id.pb_play); 
ck play = findViewById(R.id.ck_play); 
ck_play.setOnCheckedChangeListener(this); 


// 根据 SD 卡 的 文件 路 径 ， 初 始 化 媒体 播放 器 
public void init(String path) { 
mAudioPath = path; 
ck_play.setEnabled(true); 
ck_play.setTextColor(Color.BLACK); 
mMediaPlayer = new MediaPlayer0; / 创建 一 个 媒体 播放 器 
mMediaPlayer.setOnCompletionListener(this); // 设置 媒体 播放 器 的 播放 完成 监听 器 


/ 从 头 开始 播放 
private void playO { 
try{ 
mMediaPlayerreset0; // 重 置 媒 体 播放 器 
//mMediaPlayer.setVolume(0.5f. 0.5D; / 设置 音量 ， 可 选 
mMediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC); / 设置 音频 类 型 为 音乐 
/ 录制 完毕 要 等 一 秒 钟 再 setDataSource， 因 为 此 时 可 能 尚未 完成 写 入 。 
mMediaPlayersetDataSource(mAudioPath); / 设置 媒体 数据 的 文件 路 径 
mMediaPlayerprepare(); // 媒体 播放 器 准备 就 绪 
mMediaPlayer.start(); / 媒体 播放 器 开始 播放 
/ 设置 进度 条 的 最 大 值 ， 也 就 是 媒体 的 播放 时 长 
pb_play.setMax(mMediaPlayer.getDuration()); 
mTimer=new Timer0; // 创建 一 个 计时 器 
/ 计时 器 每 隔 一 秒 就 更 新 进度 条 上 的 播放 进度 
mTimer.schedule(new TimerTaskO { 
public void run(|) { 
Ppb_play.setProgress(mMediaPlayer.getCurrentPosition()); 
b 
}, 0, 1000): 
} catch (Exception e) { 
e.printStackTrace(); 





} 


/ 一 旦 发 现 媒体 播放 完毕 ， 就 触发 播放 完成 监听 器 的 onCompletion 方法 
@Override 
public void onCompletion(MediaPlayer mp) { 

isFinished = true; 

Pb_play.setProgress(100); 

ck_play.setChecked(false); 

if (mTimer !=null) { 

mTimer.cancel(); / 取消 计时 器 

b 


@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (buttonView.getIdO) 一 Riid.ck play){ 
让 (isChecked) { / 开始 播放 
ck_play.setText(" 暂 停 播放 "); 
if (isFinished) { 
play0; // 重新 播放 
}else { 
mMediaPlayerstart(); // 媒体 播放 器 恢复 播放 
上 
isFinished = false; 
} else { /W 暂停 播放 
ck_play.setText(" 开 始 播放 "); 
mMediaPlayer.pause0; // 媒体 播放 器 暂停 播放 


} 

由 于 音频 本 身 没有 对 应 的 界面 ， 因 此 只 能 使 用 进度 条 间接 表达 音频 录制 与 播放 进度 。 录 
音 与 播音 的 效果 如 图 9-18 和 图 9-19 所 示 。 其 中 ， 图 9-18 表示 当前 正在 录音 ， 图 9-15 表示 当 
前 正在 播音 。 





停止 录制 开始 录制 


暂停 播放 











图 9-18 ”正在 录音 的 界面 图 9-19 正在 播音 的 界面 
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录像 与 放映 


Android 录制 视频 与 录音 一 样 都 使 用 媒体 录制 器 MediaRecorder， 播 放 视频 与 播音 一 样 都 
使 用 媒体 播放 器 MediaPlayer。MediaRecorder 和 MediaPlayer 处 理 音频 与 视频 的 大 部 分 方法 相 
同 , 不 同 的 是 录像 与 放映 多 出 了 对 摄像 头 、 表 面 视 图 以 及 视频 进行 编码 和 解码 的 操作 。 下 面 分 
别 介绍 MediaRecorder 和 MediaPlayer 对 视频 的 额外 处 理 部 分 。 


1. 媒体 录制 器 MediaRecorder (录像 部 分 ) 
下 面 是 MediaRecorder 录制 视频 的 专用 方法 (如 果 只 是 录音 ， 就 不 需要 这 些 方法 ) 。 


e@ setCamera: 设置 相机 对 象 。 
e@ setPreviewDisplay: 设置 预览 界面 。 预 览 界 面 对 象 可 通过 SurfaceHolder 对 象 的 getSurface 





方法 获得 。 
setOrientationHint: 设置 预览 的 角度 。 跟 拍照 一 样 设置 为 90， 表 示 界 面 从 水 平方 向 到 垂 
直方 向 旋转 90 度 。 


e@ setVideoSource: 设置 视频 来 源 。 一 般 使 用 VideoSource.CAMERA 表示 摄像 头 。 
@ setOutputFormat: 设置 媒体 输出 格式 。 媒 体 输出 格式 的 取 值 说 明 见 表 9-5。 
e@ setVideoEncoder: 设置 视频 编码 器 。 一 般 使 用 VideoEncoder.MPEG 4 SP 表示 MPEG4 


编码 。 





setVideoSize: 设置 视频 的 分 辩 率 。 

setVideoFrameRate: 设置 视频 每 秒 录制 的 帧 数 。 越 大 视频 越 连贯 ， 当 然 最 终生 成 的 视频 
文件 也 越 大 。 

setVideoEncodingBitRate : 设置 视频 每 秒 录 制 的 字 节 数 。 越 大 视频 越 清 晰 ， 
setVideoFrameRate 与 setVideoEncodingBitRate 设置 一 个 即 可 。 


录像 与 录音 相 比 ， 在 界面 上 增加 了 SurfaceView， 代 码 增加 了 对 SurfaceHolder、Camera 
以 及 MediaRecorder 录像 部 分 的 处 理 。 其 中 与 MediaRecorder 有 关 的 代码 片段 见 下 (完整 源码 
参见 本 书 附带 device 模块 的 MediaRecorderjava) 。 


// 初始 化 录制 操作 

private void initRecord() { 
mMediaRecorder = new MediaRecorder(); / 创建 一 个 媒体 录制 器 
mMediaRecorder.setCamera(mCamera); // 设置 媒体 录制 器 的 摄像 头 
mMediaRecorder.setOnErrorListener(this); / 设置 媒体 录制 器 的 错误 监听 器 
mMediaRecorder.setOnInfoListener(this); / 设置 媒体 录制 器 的 信息 监听 器 
ImMediaRecordersetPreviewDisplay(mHoldergetSurface0); / 设置 媒体 录制 器 的 预览 界面 
mMediaRecorder.setVideoSource(VideoSource.CAMERA); / 设置 视频 源 为 摄像 头 
mMediaRecorder.setAudioSource(AudioSource.MIC); / 设置 音频 源 为 麦克 风 
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mMediaRecorder.setOutputFormat(OutputFormat.MPEG 4); / 设置 媒体 的 输出 格式 
mMediaRecordersetAudioEncoder(AudioEncoderAMR_NB); V/ 设置 媒体 的 音频 编码 器 
/ 如 果 录 像 报 错 : MediaRecorder start failed: -19 
// 试 试 把 setVideoSize 和 setVideoFrameRate 注释 掉 ， 因 为 尺寸 设置 必须 为 摄像 头 所 支持 
//mMediaRecorder.setVideoSize(mWidth, mHeighb; // 设置 视频 的 分 辩 率 
//mMediaRecorder.setVideoFrameRate(16); / 设置 视频 每 秒 录制 的 帧 数 
1/ setVideoFrameRate 与 setVideoEncodingBitRate 设置 其 一 即 可 
mMediaRecorder.setVideoEncodingBitRate(1 * 1024* 512); / 设置 视频 每 秒 录制 的 字 节 数 
mMediaRecordersetOrientationHint(90) / 输出 旋转 90 度 ， 也 就 是 保持 竖 屏 录制 
mMediaRecorder.setVideoEncoder(VideoEncoder.MPEG 4 SP); / 设置 媒体 的 视频 编码 器 
mMediaRecorder.setMaxDuration(mRecordMaxTime * 1000) / 设置 媒体 的 最 大 录制 时 长 
/mMediaRecordersetMaxFileSize(1024*1024*10); / 设置 媒体 的 最 大 文件 大 小 
/setMaxFileSize 与 setMaxDuration 设置 其 一 即 可 
mMediaRecordersetOutputFile(mRecordFilePath); / 设置 媒体 文件 的 保存 路 径 
ty 

ImMediaRecorderprepare0; / 媒体 录制 器 准备 就 绪 

mMediaRecorderstart(); // 媒体 录制 器 开始 录制 
} catch (Exception e) { 

e.printStack Trace(); 
bn 


2. 媒体 播放 器 MediaPlayer (放映 部 分 ) 
下 面 是 MediaPlayer 播放 视频 的 专用 方法 〈 如 果 只 是 播音 ， 就 不 需要 这 些 方法 ) 。 


setDisplay: 设置 播放 界面 ， 参 数 为 SurfaceHolder 类 型 。 
setSurface: 设置 播放 表层 ， 人 参数 可 通过 SurfaceHolder 对 象 的 getSurface 方法 获得 。 
setDisplay 与 setSurface 两 个 方法 只 需 调 用 一 个 。 

e@ setScreenOnWhilePlaying: 设置 是 否 使 用 SurfaceHolder 显示 ， 也 就 是 是 否 保持 屏幕 高 亮 ， 
从 而 持续 播放 视频 。 为 true 时 只 能 调用 setDisplay， 不 能 调用 setSurface。 

esetVideoScalingMode: 设置 视频 的 缩放 模式 ， 默 认为 MediaPlayer.VIDEO_SCALING 
MODE _ SCALE TO_FIT， 表 示 固 定 宽 高 。 

e@ setOnVideoSizeChangedListener: 设置 视频 缩放 监听 器 。 需 要 实现 接口 MediaPlayer. 
OnVideoSizeChangedListener 的 onVideoSizeChanged 方法 。 


放映 与 播音 相 比 ， 在 界面 上 增加 了 SurfaceView， 所 以 布局 文件 要 增加 声明 SurfaceView， 
代码 也 增加 了 对 SurfaceView 的 处 理 。 主 要 代码 变动 是 在 调用 prepare 方法 之 前 ， 增 加 调用 
setDisplay 方法 设置 显示 层 ,举例 如 下 (完整 源码 参见 本 书 附 带 device 模块 的 VideoPlayer.java)。 
// 把 视频 画面 输出 到 表面 视图 SurfaceView 
mMediaPlayer.setDisplay(sv_play.getHolder()); 
/ 媒体 播放 器 准备 就 绪 
mMediaPlayer.prepare(); 
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视频 录制 与 播放 的 效果 如 图 9-20 和 图 9-21 所 示 。 其 中 ， 图 9-20 所 示 为 录像 时 的 界面 ， 
图 9-21 所 示 为 放映 时 的 界面 。 


开始 录制 











图 9-20 录制 视频 时 的 效果 图 图 9-21 播放 视频 时 的 效果 图 
9.3 传感器 


本 节 介 绍 常 见 传感器 的 用 法 与 相关 应 用 场景 ， 首 先 列举 Android 目前 支持 的 传感器 种 类 ， 
然后 对 常用 传感器 分 别 进行 说 明 , 包括 加 速度 传感器 的 用 法 和 摇 一 摇 的 实现 、 磁 场 传感器 的 用 
法 和 指南 针 的 实现 ， 以 及 计 步 器 、 感 光 器 、 陀 螺 仪 等 其 他 传感器 的 基本 用 法 。 

93.1 ”传感器 的 种 类 

传感器 Sensor 是 一 系列 感应 器 的 总 称 ， 是 Android 设备 用 来 感知 周围 环境 和 运动 信息 的 
工具 。 因 为 具体 的 感应 信息 依赖 于 相关 硬件 ， 所 以 虽然 Android 定义 了 众多 感应 器 , 但 是 并 非 
每 部 手机 都 能 支持 这 么 多 感应 器 ， 千 元 以 下 的 低 端 手机 往往 只 支持 加 速度 等 少数 感应 器 。 

传感器 一 般 借助 于 硬件 监听 环境 信息 改变 ， 有 时 会 结合 软件 监听 用 户 的 运动 信息 。 目 前 ， 
Android 支持 的 传感器 类 型 见 表 9-7。 

表 9-7 ”传感器 类 型 的 取 值 说 明 














编号 | Sensor 类 的 传感器 类 型 传感器 名 称 说 明 
1 TYPE_ACCELEROMETER 加 速度 常用 于 摇 一 摇 功 能 
2 | TYPE MAGNETIC FIELD 磁场 
3 TYPE_ORIENTATION 方向 已 弃 用 ， 取 而 代 之 的 是 
getOrientation 方法 
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( 续 表 ) 

编号 | Sensor 类 的 传感器 类 型 传感器 名 称 说 明 

4 | TYPE GYROSCOPE 陀螺 仪 用 来 感应 手机 的 旋转 和 倾斜 
5 | TYPE LIGHT 光线 用 来 感应 手机 正面 的 光线 强 弱 
6 | TYPE PRESSURE 压力 用 来 感应 气压 

7 | TYPE TEMPERATURE 温度 已 弃 用 ， 取 而 代 之 的 是 类 型 13 
8 | TYPE PROXIMITY 距离 

9 | TYPE GRAVITY 重力 

10 | TYPE LINEAR ACCELERATION 线性 加 速度 

11 | TYPE ROTATION_VECTOR 旋转 矢量 

12 | TYPE _ RELATIVE_ HUMIDITY 相对 湿度 

13 | TYPE AMBIENT TEMPERATURE 环境 温度 

14 | TYPE MAGNETIC FIELD UNCALIBRATED ”| 无 标定 磁场 

15 | TYPE GAME ROTATION VECTOR 无 标定 旋转 矢量 

16 | TYPE GYROSCOPE UNCALIBRATED 未 校准 陀螺 仪 

17 | TYPE SIGNIFICANT MOTION 特殊 动作 

18 | TYPE STEP DETECTOR 步行 检测 用 户 每 走 一 步 就 触发 一 次 事件 
19 | TYPE STEP COUNTER 步行 计数 记录 激活 后 的 步伐 数 

20 | TYPE_GEOMAGNETIC ROTATION_VECTOR ”| 地 磁 旋转 矢量 

21 | TYPE HEART RATE 心跳 速率 可 穿戴 设备 使 用 ， 如 手 环 

22 | TYPE TILT_DETECTOR 倾斜 检测 

23 | TYPE WAKE GESTURE 唤醒 手势 

24 | TYPE GLANCE GESTURE 掠 过 手势 

25 | TYPE PICK UP GESTURE 拾 起 手势 








查看 当前 设备 支持 的 传感器 种 类 , 可 通过 调用 SensorManager 对 象 的 getSensorList 方法 获 
得 ,该 方法 返回 了 一 个 Sensor 队列 .遍历 Sensor 队列 中 的 每 个 元 素 ,调用 Sensor 对 象 的 getType 
方法 可 获取 该 传感器 的 类 型 ， 调 用 Sensor 对 象 的 getName 方法 则 可 获取 该 传感器 的 名 称 。 

如 图 9-22 所 示 为 某 品牌 手机 上 支持 的 传感器 列表 ， 包 含 目 前 Android 系统 定义 的 大 部 分 


传感器 。 





device 


ight Sensor 


3 方向 : LSM6DB0 iNemoEngine Orientation Sensor 
4 陀螺 仪 : LSM6DB0 Gyroscope Sensor 
加 速度 : LSI 





6 未 校准 陀 昌 Sensor 
20 地 磁 旋 转 矢量 : LSM6DB0 iNemoEngine GeoMagnetic Rotation Vector Sensor 


图 9-22 ” 某 品牌 手机 上 支持 的 传感器 列表 
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9.3.2 摇 一 摇 一 一 加 速度 传感器 


加 速度 传感器 是 最 常见 的 感应 器 ， 大 部 分 智能 手机 都 内 置 了 加 速度 传感器 。 加 速度 传 感 
器 运用 最 广泛 的 功能 是 微 信 的 摇 一 摇 , 用 户 通过 摇晃 手机 寻找 周围 的 人 , 其 他 类 似 的 应 用 还 摇 
货 子 、 玩 游戏 等 。 
下 面 以 摇 一 摇 的 实现 演示 传感器 开发 的 步骤 。 
人 1i 声明 一 个 SensorManager 对 象 ， 该 对 象 从 系统 服务 SENSOR_SERVICE 中 获取 实例 。 
人 27 重 写 Activity 的 onResume 方法 ， 在 该 方法 中 注册 传感器 监听 事件 ， 并 指定 待 监听 的 传 
感 器 类 型 。 例 如 ， 摇 一 摇 功 能 要 注册 加 速度 传感器 ， 代 码 示例 如 下 : 
/ 给 加 速度 传感器 注册 传 感 监听 器 
mSensorMegr.registerListener(this, 
mSensorMgr.getDefaultSensor(Sensor.TYPE ACCELEROMETER), 
SensorManager.SENSOR_DELAY NORMAL): 
C03 重 写 Activity 的 onPause 方法 ， 在 该 方法 中 注销 传感器 事件 ， 代 码 示例 如 下 : 


/ 注销 当前 活动 的 传 感 监听 器 
mSensorMgr.unregisterListener(this); 
04 编写 一 个 传感器 事件 监听 器 ， 该 监听 器 继承 自 SensorEventListener， 同 时 需 实现 
onSensorChanged 和 onAccuracyChanged 两 个 方法 。 其 中 ， 前 一 个 方法 在 感应 信息 变化 时 触发 ， 业 务 
逻辑 都 在 这 里 处 理 ， 后 一 个 方法 在 精度 改变 时 触发 ， 一 般 无 须 处 理 。 


下 面 是 使 用 加 速度 传感器 实现 简单 摇 一 摇 的 完整 代码 : 


public class AccelerationActivity extends AppCompatActivity implements SensorEventListener { 
private TextView tv_shake; 
private SensorManager mSensorMgr; // 声明 一 个 传 感 管理 器 对 象 
private Vibrator mVibrator; / 声明 一 个 震动 器 对 象 









































protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_acceleration); 
tv_shake = findViewById(R.id.tv_shake); 
// 从 系统 服务 中 获取 传 感 管理 器 对 象 
mSensorMegr = (SensorManager) getSystemService(Context.SENSOR_SERVICE); 
/ 从 系统 服务 中 获取 震动 器 对 象 
mVibrator = (Vibrator) getSystemService(ContextVIBRATOR_SERVICE); 

上 


protected void onPause() { 
super.onPause(); 
/ 注销 当前 活动 的 传 感 监听 器 
mSensorMegr.unregisterListener(this); 
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) 

protected void onResume() { 
super.onResume(); 
/ 给 加 速度 传感器 注册 传 感 监听 器 
mSensorMegr.registerListener(this, 


mSensorMegr.getDefaultSensor(Sensor.TYPE ACCELEROMETER), 
SensorManager.SENSOR_ DELAY NORMAL); 
b 


public void onSensorChanged(SensorEvent event) { 
让 (event.sensor.getType() 一 Sensor.TYPE_ACCELEROMETER) { // 加 速度 变更 事件 

// values[0]:X 轴 ，values[1]: Y 轴 ，values[2]: Z 轴 

float[] values = event.values; 

if ((Math.abs(values[0]) > 15 || Math.abs(values[1]) > 15 || Math.abs(values[2])> 15) { 
tv_shake.setText(DateUtil.getNowTime() + ”恭喜 您 摇 一 摇 啦 "); 
/ 系统 检测 到 摇 一 摇 事件 后 ， 震 动手 机 提示 用 户 
mVibrator.vibrate(500); 


} 


// 当 传感器 精度 改变 时 回调 该 方法 ， 一 般 无 需 处 理 
public void onAccuracyChanged(Sensor sensor int accuracy) {} 


} 
这 个 例子 很 简单 ， 一 旦 监测 到 手机 的 摇动 幅度 ”有 世 


超过 阔 值 ， 就 在 屏幕 上 打印 摇 一 摇 的 结果 说 明文 字 ， 
具体 效果 如 图 9-23 所 示 。 

9.3.3 “指南针 磁场 传感器 图 9-23 ”加 速度 传感器 实现 简单 摇 一 揪 
we 月 a Wes 


顾名思义 ， 指 南 针 只 要 找到 朝 南 的 方向 就 好 了 ， 可 是 在 App 中 并 非 使 用 一 个 方向 传感器 
这 么 简单 ,事实 上 单独 的 方向 传感器 已 经 弃 用 ,取而代之 的 是 利用 加 速度 传感器 和 磁场 传感器 ， 
通过 SensorManager 的 getRotationMatrix 方法 与 getOrientation 方法 计算 方向 角度 。 

下 面 是 结合 加 速度 传感器 与 磁场 传感器 实现 指南 针 的 完整 代码 : 


public class DirectionActivity extends AppCompatActivity implements SensorEventListener { 
private TextView tv_direction; 
private CompassView cv_sourth; / 声明 一 个 罗盘 视图 对 象 
private SensorManager mSensorMgr/ 声明 一 个 传 感 管理 器 对 象 
private float[] mAcceValues; / 加 速度 变更 值 的 数组 
private float[] mMagnValues; / 磁场 强度 变更 值 的 数组 
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protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 

setContentView(R.layout.activity_direction); 

tv_direction = findViewById(R.id.tv_direction); 

/ 从 布局 文件 中 获取 名 叫 cv_sourth 的 罗盘 视图 

cv_sourth = findViewById(R.id.cv_sourth); 

// 从 系统 服务 中 获取 传 感 管理 器 对 象 

mSensorMegr = (SensorManager) getSystemService(Context.SENSOR_SERVICE); 


protected void onPause() { 


super.onPause(); 
/ 注销 当前 活动 的 传 感 监听 器 
mSensorMegr.unregisterListener(this); 


protected void onResume() { 


super.onResume(); 
int suitable = 0; 
/ 获取 当前 设备 支持 的 传感器 列表 
List<Sensor> sensorList = mSensorMgr.getSensorList(Sensor.TYPE_ ALL); 
for (Sensor sensor : sensorList) { 
if(sensorgetType() 一 SensorTYPE_ACCELEROMETER) { // 找到 加 速度 传感器 
suitable += 1; 
} else if (sensor.getType() 一 Sensor.TYPE_MAGNETIC FIELD) { // 找到 磁场 传感器 
suitable += 10; 
} 
} 
if (suitable / 10> 0 && suitable % 10> 0){ 
/ 给 加 速度 传感器 注册 传 感 监听 器 
msSensorMgrregisterListener(this, 
mSensorMgr.getDefaultSensor(Sensor.TYPE ACCELEROMETER), 
SensorManager.SENSOR_DELAY _ NORMAL); 
// 给 磁场 传感器 注册 传 感 监听 器 
msSensorMgrregisterListener(this, 
mSensorMegr.getDefaultSensor(Sensor.TYPE MAGNETIC_FIELD), 
SensorManager.SENSOR_ DELAY _ NORMAL); 
}else{ 
cv_sourth.setVisibility(View.GONE); 
tv_direction.setText(" 当 前 设备 不 支持 指南 针 ， 请 检查 是 否 存在 加 速度 和 磁场 传感器 "); 
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public void onSensorChanged(SensorEvent event) { 


让 (event.sensor.getType() 一 Sensor.TYPE_ ACCELEROMETER) { // 加 速度 变更 事件 


mAcceValues = event.values; 


} else if (event.sensor.getType() 一 Sensor TYPE MAGNETIC FIELD) { // 磁场 强度 变更 事件 


mMagnValues = event.values; 


} 
if (mAcceValues != null && mMagnValues != null) { 


calculateOrientation(); // 加 速度 和 磁场 强度 两 个 都 有 了 ， 才 能 计算 磁极 的 方向 


} 


// 当 传感器 精度 改变 时 回调 该 方法 ， 一 般 无 需 处 理 
public void onAccuracyChanged(Sensor sensor int accuracy) {} 


/ 计算 指南 针 的 方向 

private void calculateOrientation() { 
float[] values = new float[3]; 
float[] R= new float[9]; 


SensorManager.getRotation Matrix(R, null, mAcceValues, mMagnValues); 


SensorManager.getOrientation(R, values); 

values[0] = (float) Math.toDegrees(values[0]); 

/ 设置 罗盘 视图 中 的 指南 针 方 向 

cv_sourth.setDirection((int) values[0]); 

if (values[0] >= -10 && values[0] < 10) { 
tv_direction.setText(" 手 机 上 部 方向 是 正 北 "); 

} else if (values[0] >= 10 && values[0] < 80) { 
tv_direction.setText(" 手 机 上 部 方向 是 东北 "); 

} else if (values[0] >= 80 && values[0] <= 100) { 
tv_direction.setText(" 手 机 上 部 方向 是 正 东 "); 

} else if (values[0] >= 100 && values[0] < 170) { 
tv_direction.setText(" 手 机 上 部 方向 是 东南 "); 


} else if ((values[0] >= 170 && values[0] <= 180) ‖ (values[0]) >= -180 && values[0] <-170) { 


tv_direction.setText(" 手 机 上 部 方向 是 正 南 "); 
} else if (values[0] >= -170 && values[0] <-100) { 

tv_direction.setText(" 手 机 上 部 方向 是 西南 "); 
} else if (values[0] >= -100 && values[0] < -80) { 

tv_direction.setText(" 手 机 上 部 方向 是 正 西 "); 
} else if (values[0] >= -80 && values[0] <-10) { 

tv_direction.setText(" 手 机 上 部 方向 是 西北 "); 
b 
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上 述 代 码 计算 得 到 的 只 是 手机 上 部 与 正 北方 向 的 角度 ， 要 想 在 手机 上 模拟 指南 针 的 效果 ， 
得 自己 写 一 个 罗盘 视图 , 然后 在 罗盘 上 绘制 出 正 南方 向 的 指针 。 罗盘 视图 上 的 指南 针 效 果 如 图 
9-24 和 图 9-25 所 示 。 其 中 ， 图 9-24 所 示 为 手机 上 部 对 准 正 南方 向 的 界面 ， 此 时 指南 针 恰好 位 


于 朝 上 


手机 上 部 方向 是 正 南 





图 
9.3.4 


其 他 传感器 各 有 千秋 ， 合 理 使 用 能 够 产生 许多 趣味 应 用 。 下 面 分 别 介绍 几 款 用 途 较 广 的 


例子 ， 
网 


9-24 手机 上 部 对 准 正 南方 向 时 的 指南 针 
计 步 器 、 感 光 器 和 陀螺 仪 


包括 计 步 器 、 感 光 器 、 陀 螺 仪 等 。 
计 步 器 


手机 上 部 方向 是 正 东 





的 方向 ; 转动 手机 使 上 部 对 准 正 东方 向 ， 此 时 指南 针 转 到 了 屏幕 右边 ， 如 图 9-25 所 示 。 





图 9-25 手机 上 部 对 准 正 东方 向 时 的 指南 针 


计 步 器 的 原理 是 通过 手机 的 前 后 摆动 模拟 步伐 节奏 的 监测 。Android 中 与 计 步 器 有 关 的 传 


感 器 有 


两 个 ， 


-个 是 步行 检测 (TYPE_STEP_DETECTOR ) , 另 一 个 是 步行 


计数 (TYPE _STEP_ 








COUNTER) 。 其 中 ， 步 行 检测 的 返回 数值 为 1 时 ， 表 示 当 前 监测 到 一 个 步伐 ， 步 行 计 数 的 返 





下 


面 是 使 用 计 步 器 的 代码 片段 : 


回 数值 是 累加 后 的 数值 ， 表 示 本 次 开机 激活 后 的 总 步伐 数 。 


public void onSensorChanged(SensorEvent event) { 
if (event.sensor.getType() 一 Sensor.TYPE_STEP_DETECTOR) { // 步行 检测 事件 


if (event.values[0] 一 1.0f) { 
mStepDetectort+t; 
} 


} else if (event.sensor.getType() 一 Sensor. TYPE_STEP_COUNTER) { // 计 步 器 事件 
mStepCounter = (int) event.values[0]; 


} 


String desc= String.format(" 设 备 检测 到 您 当前 走 了 %d 步 ， 总 计数 为 %d 步 ", 
mStepDetector, mStepCounter); 
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tv_step.setText(desc); 


计 步 器 的 效果 如 图 9-26 所 示 ， 可 以 看 到 计 步 器 的 总 计数 是 累加 值 。 


device 





设备 检测 到 您 当前 走 了 22 步 ， 总 计数 为 87 步 


图 9-26 计 步 器 的 效果 界面 


2. 感光 器 


感光 器 也 叫 光 线 传感器 ， 借 助 于 前 置 摄像 关 的 曝光， 一 旦 遮 住 前 置 摄像 头 ， 传 感 器 监测 
到 的 光线 强度 立马 就 会 降低 。 在 实际 开发 中 ， 光 线 传感器 往往 用 于 感应 手机 正面 的 光线 强 弱 ， 
从 而 自动 调节 屏幕 亮度 。 
使 用 光线 传感器 的 代码 片段 如 下 
public void onSensorChanged(SensorEvent event) { 
让 (event.sensor.getType() 一 Sensor.TYPE_LIGHT) { / 光线 强度 变更 事件 
float light_strength = event.values[0]; 
tv_light.setText(DateUtil.getNowTime() + ”当前 光线 强度 为 " + light_strength); 


b 
光线 传感器 的 效果 如 图 9-27 所 示 ， 光 线 强度 的 数值 每 时 每 刻 都 在 变化 。 


GL )xzsamr 


22:58:55 当前 光线 强度 为 19.756496 





图 9-27 光线 传感器 的 效果 界面 
3. 陀螺 仪 


陀螺 仪 顾名思义 是 测量 平衡 的 仪器 ， 它 的 测量 结果 为 当前 与 上 次 位 置 之 间 的 倾斜 角度 ， 
这 个 角度 描述 的 是 三 维 空间 上 的 夹 角 ， 因 而 其 数值 由 x、y、z 三 个 坐标 轴 上 的 角度 偏 移 组 成 。 
由 于 陀螺 仪 具备 三 维 角度 的 测量 功能 , 因此 它 又 被 称 作 角 速度 传感器 。 前面 介绍 的 加 速度 传 感 
器 只 能 检测 线性 距离 的 大 小 , 而 陀螺 仪 能 够 检测 旋转 角度 的 大 小 , 所 以 利用 陀螺 仪 可 以 还 原 三 
维 物 体 的 转动 行为 。 
下 面 是 使 用 陀螺 仪 的 主要 代码 片段 : 
private float mTimestamp; / 记录 上 次 的 时 间 戳 
private float mAngle[] = new float[3]; / 记录 x、y、z 三 个 方向 上 的 旋转 角度 
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public void onSensorChanged(SensorEvent event) { 
// Sensor.TYPE_GYROSCOPE 表示 当前 事件 为 陀螺 仪 传感器 
if (event.sensor.getType() 一 SensorTYPE GYROSCOPE) f 
if (mTimestamp != 0) { 
final float dT = (event.timestamp - mTimestamp) * NS2S; 
mAngle[0] += event.values[0] * dT; 
mAngle[1] += event.values[1] * dT; 
mAngle[2] += event.values[2] * dT; 
/x 轴 的 旋转 角度 ， 手 机 平 放 桌 上 ， 然 后 绕 侧 边 转动 
float angleX = (float) Math.toDegrees(mAngle[0]); 
Wy 轴 的 旋转 角度 ， 手 机 平 放 桌 上 ， 然 后 绕 底 边 转动 
float angleY = (float) Math.toDegrees(mAngle[1]); 
//z 轴 的 旋转 角度 ， 手 机 平 放 桌 上 ， 然 后 绕 垂 直线 水 平 旋转 
float angleZ = (float) Math.toDegrees(mAngle[2]); 
String desc = String.format(" 陀 螺 仪 检测 到 当前 x 轴 方向 的 转动 角度 为 %f, y 轴 方向 的 
转动 角度 为 %f，z 轴 方 向 的 转动 角度 为 %f", angleX, angleY, angleZ); 
tvy_gyroscope.setText(desc); 
} 


mTimestamp = event.timestamp; 
沿 着 不 同方 向 转动 手机 ， 陀 螺 仪 的 感应 结果 如 图 9-28 到 图 9-30 所 示 ， 其 中 图 9-28 为 手 
机 绕 侧 边 转 动 的 截图 ， 可见 此 时 x 轴 方 向 的 旋转 角度 较 大 ; 图 9-29 为 手机 绕 底 边 转动 的 截图 ， 


可 见 此 时 y 轴 方 向 的 旋转 角度 较 大 ， 图 9-30 为 手机 绕 垂直 线 水 平 旋转 的 截图 ， 可 见 此 时 z 轴 
方向 的 旋转 角度 较 大 。 


device device device 


陀螺 仪 检测 到 当前 x 轴 方向 的 转动 角度 为 陀螺 仪 检 测 到 当前 x 轴 方向 的 转动 角度 为 陀螺 仪 检测 到 当前 x 轴 方向 的 转动 角度 为 
62.854118, y 轴 方向 的 转动 角度 为 0.744626， 0.131935, y 轴 方向 的 转动 角度 为 21.074263， 0.402000, y 轴 方向 的 转动 角度 为 -0.259829， 
z 轴 方向 的 转动 角度 为 0.708709 z 轴 方向 的 转动 角度 为 -1.808771 z 轴 方向 的 转动 角度 为 -90.568275 





9-28 义 轴 的 角度 感应 图 9-29 YY 轴 的 角度 感应 图 9-30 ZzZ 轴 的 角度 感应 


9.4 手机 定位 


本 节 介 绍 手机 定位 的 手段 与 实现 ， 首 先 阑 述 手机 定位 的 工作 原理 ， 接 着 指出 各 类 定位 手 
段 对 应 的 手机 功能 开关 : 然后 对 定位 的 相关 工具 类 进行 详细 说 明 ， 包 括 定 位 条 件 器 Criteria、 
定位 管理 器 LocationManager、 定 位 监听 器 LocationListener; 最 后 演示 通过 定位 功能 获取 定位 
信息 的 用 法 。 
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9.4.1 开启 定位 功能 


不 管 近 在 眼前 ， 还 是 远 在 天 边 ， 无 论 身 在 何 处 ， 茫 落 人 海 总 能 找到 你 的 绿野仙踪 。 如 此 
神奇 的 特异 功能 ， 随 着 现代 科技 的 发 展 ， 终 于 由 定位 导航 技术 实现 了 。 定 位 功能 使 用 得 相当 广 
泛 ， 许 多 App 都 需要 使 用 定位 功能 找到 用 户 所 在 的 城市 ， 然 后 切换 到 对 应 的 城市 频道 。 根 据 
不 同 的 定位 方式 ， 手 机 定位 又 分 为 卫星 定位 和 网 络 定位 两 大 类 。 

卫星 定位 服务 由 几 个 全 球 卫星 导航 系统 提供 ， 主 要 包括 美国 GPS、 俄 罗斯 格 洛 纳 斯 、 中 
国 北斗 。 卫 星 定位 的 原理 是 根据 多 颗 卫星 与 导航 芯片 的 通信 结果 得 到 手机 与 卫星 距离 ,然后 计 
算 手机 当前 所 处 的 经 度 、 纬 度 以 及 海拔 高 度 ， 具 体 场景 如 图 9-31 所 示 。 使 用 卫星 定位 需 开 启 
手机 上 的 GPS 功能 ， 并 且 最 好 在 室外 使 用 ， 因 为 室内 不 容易 收 到 卫星 的 定位 信号 。 

网 络 定位 有 基站 定位 与 WiFi 定位 两 个 子 类 。 手机 插 上 运营 商 提供 的 SIM 卡 后 , 这 个 SIM 
卡 会 搜索 周围 的 基站 信号 并 接 入 通信 服务 。 手 机 基站 俗称 铁塔 ， 每 个 铁塔 都 有 对 应 的 编号 、 位 
置信 息 、 信 和 号 覆盖 区 域 。 基 站 定位 的 原理 是 监测 SIM 卡 能 搜索 到 周围 的 哪些 基站 ， 手 机 必然 
处 于 这 些 基 站 信号 覆盖 的 重 琶 区 域 ， 再 根据 每 个 基站 的 位 置信 息 就 能 得 出 手机 的 大 致 方位 了 ， 
具体 场景 如 图 9-32 所 示 。 使 用 基站 定位 需 开 启 手机 上 的 数据 连接 功能 。 








图 9-31 卫星 定位 的 应 用 场景 图 9-32 ”基站 定位 的 应 用 场景 


WiFi 定位 的 原理 是 手机 接 入 某 个 公共 热点 网 络 ， 比 如 首都 机 场 的 WiFi， 提 供 WiFi 热点 
的 路 由 器 有 自身 的 MAC 地 址 与 电信 宽带 的 网 络 IP， 通 过 查询 WiFi 路 由 器 的 位 置 便 可 得 知 接 
入 该 WiFi 手机 的 大 致 位 置 。 使 用 WiFi 定位 需 开 启 手机 上 的 WLAN 功能 。 

无 论 是 基站 定位 还 是 WiFi 定位 ， 手 机 自身 只 能 获取 基站 与 WiFi 路 由 器 的 信息 ， 无 法 直 
接 得 到 手机 的 位 置信 息 。 要 想 获得 具体 的 方位 ， 必 须 先 把 基站 或 WiFi 路 由 器 的 信息 传 给 位 置 
服务 提供 商 ( 比 如 高 德 地 图 或 百度 地 图 )， 位 置 服务 器 储存 了 每 个 基站 和 WiFi 路 由 器 的 编号 、 
MAC 地 址 、 实 际 位 置 ， 从 这 个 庞大 的 网 络 数据 库 找到 具体 基站 或 WiFi 的 详细 位 置 ， 再 返回 
给 手机 客户 端 。 因 为 需要 后 端的 网 络 参与 计算 手机 的 位 置信 息 ， 所 以 基站 定位 和 WiFi 定位 统 
称 为 网 络 定位 ， 国 产 手机 网 络 定位 的 计算 功能 由 高 德 地 图 和 百度 地 图 分 别提 供 。 

既然 无 论 使 用 卫星 定位 ， 还 是 基站 定位 、WiFi 定位 ， 都 要 开启 对 应 的 手机 功能 ， 那 么 首 
先 得 获取 这 些 功 能 的 开关 状态 ， 然 后 根据 需要 开启 或 关闭 对 应 的 功能 。 下 面 是 对 GPS、 数 据 
连接 、WLAN 功能 进行 状态 获取 和 开关 操作 的 代码 : 

// 获取 定位 功能 的 开关 状态 
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public static boolean getGpsStatus(Context ctx) { 
/ 从 系统 服务 中 获取 定位 管理 器 
LocationManager lm = (Location Manager) ctx.getSystemService(ContextLOCATION SERVICE); 
return lm.isProviderEnabled(Location Manager.GPS_PROVIDER); 

b 


/ 检查 定位 功能 是 否 打开 ， 若 未 打开 则 跳 到 系统 的 定位 功能 设置 页 面 
public static void checkGpsIsOpen(Context ctx, String hint) { 
if (!getGpsStatus(ctx)) { 
Toast.make Text(ctx, hint, Toast. LENGTH_SHORT).showO; 
Intent intent = new Intent(Settings.ACTION_ LOCATION SOURCE SETTINGS); 
ctx.startActivity(intent); 


, 


// 获取 无 线 网 络 的 开关 状态 

public static boolean getWlanStatus(Context ctx) { 
// 从 系统 服务 中 获取 无 线 网 络 管理 器 
WifiManager wm = (WifiManager) ctx.getSystemService(Context. WIFI SERVICE); 
return wm.isWifiEnabled(); 

) 


/ 打开 或 关闭 无 线 网 络 

public static void setWlanStatus(Context ctx, boolean enabled) { 
/ 从 系统 服务 中 获取 无 线 网 络 管理 器 
WifiManager wm = (WifiManager) ctx.getSystemService(Context WIFI SERVICE); 
wm.setWifiEnabled(enabled); 

有 


/ 获取 数据 连接 的 开关 状态 
public static boolean getMobileDataStatus(Context ctx) { 
/ 从 系统 服务 中 获取 连接 管理 器 
ConnectivityManager cm = (ConnectivityManager) 
ctx.getSystemService(Context.CONNECTIVITY_SERVICE); 
boolean isOpen = false; 
try{ 
String methodName = "getMobileDataEnabled"; / 这 是 隐藏 方法 ， 需 要 通过 反射 调用 
Method method = cm.getClass().getMethod(methodName); 
isOpen = (Boolean) method.invoke(cm); 
} catch (Exception e) { 
e.printStack Trace(); 
} 
return isOpen:; 
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} 


/ 打开 或 关闭 数据 连接 
public static void setMobileDataStatus(Context ctx, boolean enabled) { 
/ 从 系统 服务 中 获取 连接 管理 器 
ConnectivityManager cm = (ConnectivityManager) 
ctx.getSystemService(Context.CONNECTIVITY SERVICE); 
try{ 
String methodName = "setMobileDataEnabled"; // 这 是 隐藏 方法 ， 需 要 通过 反射 调用 
Method method = cm.getClass().getMethod(methodName, Boolean.TYPE); 
method.invoke(cm, enabled); 
} catch (Exception e) { 
e.printStackTrace(); 
b 


以 上 定位 的 相关 功能 还 需 在 AndroidManifest.xml 中 补充 对 应 的 权限 信息 ， 具 体 的 权限 说 

明 如 下 : 

<!-- 定位 --> 

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 

<uses-permission android:name="android.permission.ACCESS_COARSE _ LOCATION" /> 

<!-- 查看 网 络 状态 -> 

<uses-permission android:name="android.permission.ACCESS_NETWORK _ STATE" /> 

<uses-permission android:name="android.permission.ACCESS_WIFI STATE'" /> 

<!-- 查看 手机 状态 -> 

<uses-permission android:name="android.permission.READ PHONE _STATE" 亡 


9.4.2 ”获取 定位 信息 
开启 定位 相关 功能 只 是 将 定位 的 前 提 条 件 准备 好 ， 若 想 获得 手机 当前 所 处 的 位 置信 息 ， 


还 要 依靠 一 系列 定位 工具 。 与 定位 信息 获取 有 关 的 工具 有 定位 条 件 器 Criteria、 定 位 管理 器 
LocationManager、 定 位 监听 器 LocationListener。 下 面 对 这 3 个 工具 分 别 进行 介绍 。 


1. 定位 条 件 器 Criteria 
定位 条 件 器 用 于 设置 定位 的 前 提 条 件 ， 比 如 精度 、 速 度 、 海 拔 、 方 位 等 信息 ， 有 以 下 6 
个 常用 参数 。 


esetAccuracy: 设置 定位 精确 度 。 有 两 个 取 值 ，Criteria.ACCURACY _FINE 表示 精度 高 ， 
Criteria.ACCURACY_COARSE 表示 精度 低 。 
esetSpeedAccuracy: 设置 速度 精确 度 。 速 度 精 确 度 的 取 值 说 明 见 表 9-8。 
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表 9-8 ”速度 精确 度 的 取 值 说 明 
Criteria 类 的 速度 精确 度 说 明 





ACCURACY_HIGH 


精度 高 ， 误 差 小 于 100 米 





ACCURACY MEDIUM 


精度 中 等 ， 误 差 在 100 米 到 500 米 之 间 





ACCURACY _ LOW 


2. 


精度 低 ， 误 差 大 于 500 米 





setAltitudeRequired: 设置 是 否 需要 海拔 信息 。 取 值 true 表示 需要 ，false 表示 不 需要 。 
setBearingRequired: 设置 是 否 需要 方位 信息 。 取 值 true 表示 需要 ，false 表示 不 需要 。 
setCostAllowed: 设置 是 否 允 许 运 营 商 收费 。 取 值 tue 表示 允许 ，false 表示 不 允许 。 
setPowerRequirement: 设置 对 电源 的 需求 。 有 3 个 取 值 ，Criteria. POWER_LOW 表示 耗 
电 低 ，Criteria. POWER_MEDIUM 表示 耗 电 中 等 ，Criteria POWER_HIGH 表示 耗 电 高 。 


定位 管理 器 LocationManager 


定位 管理 器 用 于 获取 定位 信息 的 提供 者 、 设 置 监听 器 ， 并 获取 最 近 一 次 的 位 置信 息 。 定 
位 管理 器 的 对 象 从 系统 服务 LOCATION_SERVICE 获取 ， 常 用 方法 有 以 下 7 个 。 








。 getBestProvider: 获取 最 佳 的 定位 提供 者 。 第 一 个 参数 为 定位 条 件 器 Criteria 的 实例 ， 第 
二 个 参数 取 值 true 表示 只 要 可 用 的 。 定 位 提供 者 的 取 值 说 明 见 表 9-9。 
表 9-9 定位 提供 者 的 取 值 说 明 
定位 提供 者 的 名 称 说 明 定位 功能 的 开启 状态 
gps 卫星 定位 开启 GPS 功能 
metwork 网 络 定位 开启 数据 连接 或 WLAN 功能 
passive 无 法 定位 未 开启 定位 相关 功能 








e@ isProviderEnabled: 判断 指定 的 定位 提供 者 是 否 可 用 。 
egetLastKnownLocation: 获取 最 近 一 次 的 定位 地 点 。 
erequestLocationUpdates: 设置 定位 监听 器 。 其中， 第 一 个 参数 为 定位 提供 者 ， 第 二 个 参 


数 为 位 置 更 新 的 最 小 间隔 时 间 ， 第 三 个 参数 为 位 置 更 新 的 最 小 距离 ， 第 四 个 参数 为 定位 
监听 器 实例 。 


e@ removeUpdates: 移 除 定位 监听 器 。 
e@ addGpsStatusListener: 添加 定位 状态 的 监听 器 。 该 监听 器 需 实现 GpsStatus.Listener 接口 


3. 


的 onGpsStatusChanged 方法 。 
removeGpsStatusListener: 移 除 定位 状态 的 监听 器 。 


定位 监听 器 LocationListener 


定位 监听 器 用 于 监听 定位 信息 的 变化 事件 ， 如 定位 提供 者 的 开关 、 位 置信 息 发 生变 化 等 。 
该 监听 器 可 使 用 以 下 4 种 方法 。 


onLocationChanged: 在 位 置地 点 发 生变 化 时 调用 。 在 此 可 获取 最 新 的 位 置信 息 。 
onProviderDisabled: 在 定位 提供 者 被 用 户 关闭 时 调用 。 
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。 onProviderEnabled: 在 定位 提供 者 被 用 户 开启 时 调用 。 
e。 onStatusChanged: 在 定位 提供 者 的 状态 变化 时 调用 。 定 位 提供 者 的 状态 取 值 见 表 9-10。 


表 9-10 ”定位 提供 者 的 状态 取 值 说 明 











LocationProvider 类 的 状态 类 型 说 明 

OUT_ OF SERVICE 在 服务 范围 外 
TEMPORARILY_UNAVAILABLE 暂时 不 可 用 
AVAILABLE 可 用 状态 





获取 定位 信息 的 示例 代码 如 下 : 


public class LocationActivity extends AppCompatActivity { 
private TextView tv_location; 
private String mLocation = ""; 
private LocationManager mLocationMgr; / 声明 一 个 定位 管理 器 对 象 
Private Criteria mCriteria = new Criteria(); / 声明 一 个 定位 准则 对 象 
private HandlermHandler= new Handler(); / 声明 一 个 处 理 器 
private boolean isLocationEnable = false; / 定位 服务 是 否 可 用 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_location); 
tv_location = findViewById(R.id.tv_location); 
SwitchUtil.checkGpsIsOpen(this, "需要 打开 定位 功能 才能 查看 定位 结果 信息 "); 


protected void onResume() { 
super.onResume(); 
mHandler.removeCallbacks(mRefresh); / 移 除 定位 刷新 任务 
initLocation(); / 初始 化 定位 服务 
mHandler.postDelayed(mRefresh, 100); V/ 延迟 100 毫秒 启动 定位 刷新 任务 


// 初始 化 定位 服务 

private void initLocation0O) { 
/ 从 系统 服务 中 获取 定位 管理 器 
mLocationMgr=(LocationManager) getSystemService(Context.LOCATION_SERVICE); 
/ 设置 定位 精确 度 。ACCURACY_COARSE 表示 粗略 ，ACCURACY _FIN 表示 精细 
mCriteria.setAccuracy(Criteria. ACCURACY FINE); 
mCriteria.setAltitudeRequired(true); / 设置 是 否 需要 海拔 信息 
mCriteria.setBearingRequired(true); / 设置 是 否 需 要 方位 信息 
mCriteria.setCostAllowed(true); / 设置 是 否 允 许 运 营 商 收费 
moCriteria.setPowerRequirement(Criteria POWER_LOW); / 设置 对 电源 的 需求 
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/ 获取 定位 管理 器 的 最 佳 定 位 提供 者 

String bestProvider = mLocation Megr.getBestProvider(mCriteria, true); 

让 (mLocationMgrisProviderEnabled(bestProvider)) { // 定位 提供 者 当前 可 用 
tv_location.setText(" 正 在 获取 " + bestProvider + "定位 对 象 "); 
mLocation = String.format(" 定 位 类 型 =%s", bestProvider); 
beginLocation(bestProvider); 
isLocationEnable = true; 

} else { // 定位 提供 者 暂 不 可 用 
tv_location.setText("\n" + bestProvider + "定位 不 可 用 "); 
isLocationEnable = false; 


) 


/ 设置 定位 结果 文本 
private void setLocationText(Location location) { 
if (location != null) { 
String desc = String.format("%sn 定位 对 象 信息 如 下 : "+ 
"nt 其 中 时 间 : %s" + "mAt 其 中 经 度 : %f， 纬 度 : %f" 十 
"nt 其 中 高 度 : %d 米 ， 精 度 : %d 米 "， 
mLocation, DateUtil.getNowDateTimeFormat(), 
location.getLongitude(), location.getLatitude(), 
Math.round(location.getAltitude()), Math.round(location.getAccuracy())); 
tv_location.setText(desc); 
} else { 
tv_location.setText(mLocation + "\n 暂 未 获取 到 定位 对 象 ); 


) 


/ 开始 定位 
private void beginLocation(String method) { 
/ 检查 当前 设备 是 否 已 经 开启 了 定位 功能 
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE LOCATION) 
!= PackageManager.PERMISSION_GRANTED) { 
Toast.makeText(this, "请 授予 定位 权限 并 开启 定位 功能 ", Toast LENGTH_SHORT).show(); 
return; 
;; 
/ 设置 定位 管理 器 的 位 置 变更 监听 器 
mLocationMSgrrequestLocationUpdates(method, 300, 0, mLocationListener); 
/ 获取 最 后 一 次 成 功 定位 的 位 置信 息 
Location location = mLocation Mgr.getLastKnownLocation(method); 
setLocationText(location); 
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private LocationListener mLocationListener =new LocationListener() { 


public void onLocationChanged(Location location) { V// 位 置 发 生变 化 时 触发 
setLocationText(location); 
} 


public void onProviderDisabled(String arg0) f} // 定位 提供 者 不 可 用 时 触发 
public void onProviderEnabled(String arg0) {} // 定位 提供 者 可 用 时 触发 


public void onStatusChanged(String arg0, int argl, Bundle arg2) {} // 状态 变更 时 触发 
上 


// 定义 一 个 刷新 任务 ， 若 无 法 定位 则 每 隔 一 秒 就 尝试 定位 
private Runnable mRefresh = new Runnable() { 
public void run() { 


if (!isLocationEnable) { 
initLocation(); 


mHandler.postDelayed(this, 1000); 
}; 


protected void onDestroy() { 
if (mLocationMgr != null) { 
// 移 除 定位 管理 器 的 位 置 变 更 监听 器 


mLocationMgr.removeUpdates(mLocationListener); 
} 


super.onDestroy(); 
} 
获取 定位 信息 的 效果 如 图 9-33 所 示 ， 当 前 定位 类 型 是 卫星 定位 ,定位 结果 


是 东经 119 度 、 
北纬 26 度 ， 海 拔高 度 137 米 ， 定 位 精度 13 米 。 





定位 类 型 =gps 
定位 对 象 信息 如 下 : 
其 中 时 间 : 2018-05-23 22:49:57 


其 中 经 度 : 119.332208, 纬度 : 26.145819 
其 中 高 度 : 137 米 , 精度 : 13 米 





图 9-33 菜 设备 获取 的 定位 信息 
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9.5 ” 短 距 离 通信 


手机 除了 可 以 操纵 自身 装载 的 设备 ， 还 能 借助 短 距离 通信 技术 来 控制 附近 的 设备 ， 比 如 
刷卡 、 遥 控 电 器 、 播 放 蓝牙 音箱 等 。 本 节 就 介绍 常见 的 几 种 短 距离 通信 技术 ， 首 先 描述 了 NFC 
与 RFID 两 种 标准 的 异同 点 ， 以 及 NFC 近 场 通信 在 App 开发 中 的 运用 ;然后 说 明 红 外 遥控 和 
射频 遥控 各 自 的 适用 场景 , 以 及 如 何 利用 红外 信号 遥控 家 用 电器 ; 最 后 阐述 了 普通 蓝牙 与 低 功 
耗 蓝 牙 (BLE) 的 区 别 ， 以 及 两 台 蓝 牙 设 备 如 何 发 现 对 方 并 进行 配对 。 


9.5.1 NFC 近 场 通信 


NFC 的 全 称 是 “Near Field Communication”， 意 思 是 近 场 通信 、 与 邻近 的 区 域 通信 。 大 
众 所 熟 知 的 NFC 技术 应 用 ， 主 要 是 智能 手机 的 刷卡 支付 功能 。 别 看 智能 手机 是 近 十 年 前 才 出 
现 的 ，NFC 的 历史 可 比 智能 手机 要 您 久 得 多 ， 它 脱胎 于 上 世纪 的 RFID 无 线 射频 识别 技术 。 

所 谓 RFID 是 “Radio Frequency Identification” 的 缩写 ， 它 通过 无 线 电 信号 便 可 识别 特定 
目标 并 读 写 数据 , 而 无 需 自身 与 该 目标 之 间 建 立 任何 机 械 或 者 光学 接触 。 像 日 常生 活 中 的 门禁 
卡 、 公 交 卡 ， 乃 至 二 代 身 份 证 ， 都 是 采用 了 RFID 技术 的 卡片 。 若 想 读 写 这 些 RFID 卡片 ， 则 
需 相应 的 读 卡 器 ， 只 要 用 户 把 卡片 靠近 ， 读 卡 器 就 会 产生 感应 动作 。 

既然 RFID 已 经 广泛 使 用 ， 那 么 何苦 又 要 另外 制定 NFC 标准 呢 ? 其 实 正 是 因为 RFID 用 
得 地 方太 多 了 ， 导 致 随意 性 较 大 ， 反 而 不 便于 更 好 地 管控 。 所 以 业界 重新 定义 了 NFC 规范 ， 
试图 在 两 个 方面 弥补 RFID 的 固有 缺 城 : 


(1) RFID 的 信号 传播 距离 较 远 ， 致 使 位 于 远 处 的 设备 也 可 能 获取 卡片 信息 ， 这 对 安全 
性 较 高 的 场合 是 不 可 接受 的 。 而 NFC 的 有 效 工作 距离 在 十 厘米 之 内 ， 即 可 避免 卡片 信息 被 窃 
取 的 风险 。 

(2) RFID 的 读 写 操作 是 单 向 的 ， 也 就 是 说 ， 只 有 读 卡 器 能 读 写 卡片 ， 卡 片 不 能 拿 读 卡 
器 怎么 样 。 现 在 NFC 不 再 沿用 “ 读 卡 器 一 一 卡片 ”的 模式 ， 取 而 代 之 的 是 只 有 NFC 设备 的 概 
念 , 两 个 NFC 设备 允许 互相 读 写 , 既 可 以 由 设备 A 读 写 设备 B, 也 可 以 由 设备 B 读 写 设备 A。 


改进 之 后 的 NFC 技术 既 提 高 了 安全 性 ， 又 拓宽 了 应 用 场合 ， 同 时 还 兼容 现 有 的 大 部 分 
RFID 卡片 ， 因 此 在 智能 手机 上 运用 NFC 而 非 RFID 也 就 不 足 为 怪 了 。 

带 有 NFC 功能 的 手机 ， 在 实际 生活 中 主要 有 三 项 应 用 : 读 卡 器 、 仿 真 卡 把 手机 当 卡 片 
用 ) 、 分 享 内 容 ( 两 部 手机 之 间 传 输 数 据 ) 。 为 了 能 更 迅速 地 了 解 NFC 技术 在 Android 中 的 
开发 流程 ， 下 面 通过 相对 简单 的 读 卡 器 功能 ， 来 介绍 如 何 进 行 手 机 App 的 NFC 开发 。 


301 首先 要 在 AndroidManifestxml 中 声明 NFC 的 操作 权限 ， 下 面 是 配置 声明 的 例子 : 





<!--NFC --> 

<uses-permission android:name="android.permission.NFC" /> 

<!-- 仅 在 支持 NFC 的 设备 上 运行 -> 

<uses-feature android:name="android.hardware.nfc" android:required="true" /> 
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G302 其 次 还 要 对 活动 页 面 声明 NFC 过 滤器 ， 目 前 Android 支持 NDEF_DISCOVERED、 
TAG_DISCOVERED、TECH_DISCOVERED 这 三 种 ， 最 好 把 它们 都 加 入 到 过 滤器 列表 中 ， 示 例如 下 : 








<activity android:name=".NfcActivity"> 
<intent-filter> 
<action android:name="android.nfc.action.NDEF_ DISCOVERED" /> 
</intent-filter> 
<intent-filter> 
<action android:name="android.nfc.action.TAG DISCOVERED" /> 
<category android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 
<intent-filter> 
<action android:name="android.nfc.action.TECH_DISCOVERED" /> 
</intent-filter> 
<meta-data 
android:name="android.nfc.action.TECH_DISCOVERED" 
android:resource="(Dxml/nfe_tech filter" /> 
</activity> 


其 中 TECH_DISCOVERED 类 型 另外 指定 了 过 滤器 的 来 源 是 @xml/nfc_tech_filter， 该 文件 
的 实际 路 径 为 xmlnfe_tech_filterxml， 文 件 内 容 如 下 所 示 : 


<resources> 
<!-- 可 以 处 理 所 有 Android 支持 的 NFC 类 型 --> 
<tech-list> 
<tech>android.nfc.tech.NfcA</tech> 
<tech>android.nfc.tech.NfcB</tech> 
<tech>android.nfc.tech.NfcF</tech> 
<tech>android.nfc.tech.NfcV</tech> 
<tech>android.nfc.tech.IsoDep</tech> 
<tech>android.nfc.tech.Ndef</tech> 
<tech>android.nfc.tech.NdefFormatable</tech> 
<tech>android.nfc.tech.MifareClassic</tech> 
<tech>android.nfc.tech.MifareUltralight</tech> 
</tech-list> 
</resources> 


上 面 的 过 滤器 列表 乍 看 过 去 真是 令 人 大 吃 一 惊 ， 这 都 是 些 什么 东 东 ， 它 们 之 间 有 哪些 区 
别 呢 ?倘若 认真 对 这 几 个 专业 术语 追根 溯源 ， 势 必要 一 番 长 篇 大 论 才能 理 清 其 中 的 历史 脉络 ， 
寻 此 不 妨 将 事情 简单 化 ， 这 些 NFC 类 型 只 不 过 是 一 个 大 家 族 内 部 的 兄弟 姐妹 罢了 。 璧 如 说 中 
近代 史上 显赫 的 宋 氏 三 姐妹 ， 原 是 同一 对 父母 ， 然 后 分 别 嫁 给 三 个 人 罢了 。NFC 类 型 虽 多 ， 
常见 的 NfcA、NfcB、IsoDep 三 个 系 出 ISO 14443 标准 〈 即 RFID 卡 标准 ) ， 它 们 仁 各 自用 于 
生活 中 的 几 种 场景 ， 说 明 如 下 : 


(1) NfcA 遵循 ISO 14443-3A 标准 ， 常 用 于 门禁 卡 。 
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(2) NfcB 遵循 ISO 14443-3B 标准 ， 常 用 于 二 代 身 份 证 。 
(3) IsoDep 遵循 ISO 14443-4 标准 ， 常 用 于 公交 卡 。 


除了 以 上 三 个 常见 的 子 标准 ，NFC 另 有 其 他 几 个 子 标准 ， 这 些 子 标准 的 名 称 及 其 适用 场 
合 详 见 表 9-11。 


表 9-11 NFC 各 子 标准 的 使 用 场景 





NFC 数据 格式 名 称 ISO 标准 名 称 实际 应 用 场合 

















NfeA | Iso 144433A 门禁 卡 

NfeB | Iso 14443-3B 二 代 身 份 证 

NfeF [ns 63194 香港 八达通 

NfeV | Iso 15693 深圳 图 书馆 读者 证 

IsoDep | TSo 144434 北京 一 卡通 、 深 圳 通 、 西 安 长 安 通 、 武 汉 通 、 广 州 羊城 通 





E703 好 不 容易 把 AndroidManifest.xml 的 相关 配置 弄 完 ， 接 着 便 是 代码 方面 的 处 理 逻 辑 了 。 
NFC 编码 主要 有 3 个 步骤 : 初始 化 适配器 、 启 用 感应 /禁用 感应 、 接 收 到 感应 消息 并 对 消息 解码 ， 下 
面 分 别 进行 介绍 。 

















1. 初始 化 NFC 适配器 
这 里 的 初始 化 动作 又 可 分 解 为 3 部 分 : 


(1) 调用 NfcAdapter 类 的 getDefaultAdapter 方法 ， 获 取 系 统 当前 默认 的 NFC 适配器 。 
这 个 NfeAdapter 与 列表 适配器 的 概念 不 一 样 ， 它 其 实 是 Android 的 NFC 管理 工具 。 

(2) 声明 一 个 延迟 意图 , 告诉 系统 一 旦 接收 到 NFC 感应 , 则 应 当 启动 哪个 页 面 进行 处 理 。 

(3) 定义 一 个 NFC 消息 的 过 滤器 ， 这 个 过 滤器 是 AndroidManifest.xml 所 配置 过 滤器 的 
子 集 。 因 为 接 下 来 要 读 取 的 卡片 兼容 RFID 标准 (ISO14443 家 族 ) ， 所 以 过 滤器 的 动作 名 称 
为 NfecAdapter.ACTION_TECH_DISCOVERED, 并 且 设 置 该 动作 包含 了 两 项 卡片 标准 , 分别 是 
NfcA〔 用 于 门禁 卡 ) 和 IsoDep( 用 于 公交 卡 )。 

详细 的 NFC 初始 化 代码 示例 如 下 : 


private NfcAdapter mNfcAdapter; / 声明 一 个 NFC 适配器 对 象 
private void initNfe() { 
/ 获取 默认 的 NFC 适配器 
ImN 人 Adapter = NfcAdapter.getDefaultA dapter(this); 
if (mNfecAdapter == null) { 
tv_nfe_resultsetText(" 当 前 手机 不 支持 NFC"); 
return; 
} else if (ImNfcAdapter.isEnabledO)) { 
tv_nfe_result.setText(" 请 先 在 系统 设置 中 启用 NFC 功能 "); 
return; 
上 
/ 探测 到 NFC 卡片 后 ， 必 须 以 FLAG_ACTIVITY_SINGLE_TOP 方式 启动 Activity， 
// 或 者 在 AndroidManifestxml 中 设置 launchMode 属性 为 singleTop 或 者 singleTask， 
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// 保证 无 论 NFC 标签 靠近 手机 多 少 次 ，Activity 实例 都 只 有 一 个 。 
Intent intent = new Intent(this, NfcActivity.class) 
.addFlags(Intent.FLAG ACTIVITY_SINGLE TOP); 
/ 声明 一 个 NFC 卡片 探测 事件 的 相应 动作 
mPendingIntent = PendingIntent.getActivity(this, 0, 
intent, PendingIntent.FLAG _ UPDATE CURRENT); 
try{ 
// 定义 一 个 过 滤器 检测 到 NFC 卡片 ) 
mFilters = new IntentFilter[] {new IntentFilter(NfcAdapter.ACTION_TECH DISCOVERED， 
Ds 
} catch (Exception e) { 
e.printStackTrace(); 
bp 
/ 读 标签 之 前 先 确 定 标签 类 型 
mTechLists = new String[][] {new String[] {NfeA.class.getName()}, {IsoDep.class.getName()}}; 


2. 启用 NFC 感应 /禁用 NFC 感应 


为 了 让 测试 App 能 够 接收 NFC 的 感应 动作 ， 需 要 重 载 Activity 的 onResume 函数 ， 在 该 
函数 中 调用 NFC 适配器 的 enableForegroundDispatch 方法 ， 指 定 启用 NFC 功能 时 的 响应 动作 
以 及 过 滤 条 件 。 另 外 也 需 重 载 onPause 函数 ,在 该 函数 中 调用 NFC 适配器 的 
disableForegroundDispatch 方法 ， 表 示 当 前 页 面 在 暂停 状态 之 时 不 再 接收 NFC 感应 消息 。 具体 
的 NFC 启用 和 禁用 代码 如 下 所 示 : 

protected void onResume() { 
super.onResume(); 
if (mNfcAdapter!=null && mNfcAdapter.isEnabled()) { 


// 为 本 App 启用 NFC 感应 
mNfcAdapter.enableForegroundDispatch(this, mPendingIntent, mFilters, mTechLists); 


} 
} 
public void onPause() { 
super.onPause(); 
if (mNfecAdapter!=null && mNfcAdapter.isEnabled()) { 
// 禁用 本 App 的 NFC 感应 
mNfcAdapterdisableForegroundDispatch(this); 
} 
} 


3. 接收 到 感应 消息 并 对 消息 解码 
通过 前 面 的 第 二 步 启 用 NFC 感应 之 后 ， 一 旦 App 接收 到 感应 消息 ， 就 会 回调 Activity 的 
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onNewIntent 函数 ， 因 此 开发 者 可 以 奸 
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connect: 连接 卡片 数据 。 
close: 释放 卡片 数据 。 


getType: 获取 卡片 的 类 型 。TYPE_CLASSIC 表示 传统 类 型 ,TYPE_PLUS 表示 增强 类 型 ， 


TYPE _PRO 表示 专业 类 型 。 
getSectorCount: 获取 卡片 的 肩 区 数量 。 


e@ getBlockCount: 获取 卡片 的 分 块 个 数 。 
e getSize: 获取 卡片 的 存储 空间 大 小 ， 单 位 字 节 。 


使 用 MifareClassic 工具 查询 卡片 数据 的 流程 很 常规 ， 先 调用 connect 方法 建立 连接 ， 然 后 
调用 各 个 get 方法 获取 详细 信息 ， 最 后 调用 close 方法 关闭 连接 。 具 体 的 门禁 卡 读 取 代码 示例 


如 下 : 


protected void onNewIntent(Intent intent) { 
super.onNewIntent(intent); 


String action = intent.getAction0; / 获取 到 本 次 启动 的 action 

if (action.equals(NfcAdapter ACTION_NDEF_DISCOVERED) // NDEF 类 型 
llaction.equals(NfeAdapterACTION_TECH_DISCOVERED) // 其 他 类 型 
由 action.equals(NfcAdapter.ACTION_TAG_DISCOVERED)) { // 未 知 类 型 


/ 从 intent 中 读 取 NFC 卡片 内 容 


Tag tag = intent.getParcelableExtra(NfcAdapterEXTRA_TAG); 


/ 获取 NFC 卡片 的 序列 号 
byte[] ids = tag.getId(); 


String card_info = String.format(" 卡 片 的 序列 号 为 : %s"， 
ByteArrayChange.ByteArrayToHexString(ids)); 


String result = readGuardCard(tag); 


card_info = String.format("%s\n 详细 信息 如 下 : \n%s", card_info, result); 


tv_nfe_result.setText(card_info); 


b 


/ 读 取 小 区 门禁 卡 信息 
public String readGuardCard(Tag tag) { 
MifareClassic classic = MifareClassic.get(tag); 
String info; 
try{ 
classic.connect0; // 连接 卡片 数据 
int type = classic.getType0; /获取 TAG 的 类 型 
String typeDesc; 


和 E 写 该 函数 来 处 理 NFC 的 消息 内 容 。 以 NFC 技术 常见 的 
小 区 门禁 卡 为 例 ， 门 禁 卡 采 取 的 子 标准 为 NfcA， 对 应 的 数据 格式 则 为 MifareClassic。 于 是 利 
用 MifareClassic 类 的 相关 方法 即 可 获取 卡片 数据 ， 下 面 是 MifareClassic 类 的 方法 说 明 。 


get: 从 Tag 对 象 中 获取 卡片 对 象 的 信息 。 该 方法 为 静态 方法 。 
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if (type 一 MifareClassic.TYPE CLASSIC) { 
typeDesc = "传统 类 型 "; 
} else if (type — MifareClassic.TYPE PLUS){ 
typeDesc = "增强 类 型 "; 
} else if (type — MifareClassic.TYPE PRO) { 
typeDesc = "专业 类 型 "; 
}else{ 
typeDesc = "未 知 类 型 "; 
} 
info = String.format("\t 卡片 类 型 : %s\nt 扇 区 数量 : %dn\t 分 块 个 数 : %d\n\t 存储 空间 : 
%d 字 节 ", typeDesc, classic.getSectorCount(), classic.getBlockCount(), classic.getSize()); 
} catch (Exception e) { 
e.printStack Trace(); 
info = e.getMessage(); 
} finally { / 无 论 是 否 发 生 异常 ， 都 要 释放 资源 
ty { 
classic.close0; / 释放 卡片 数据 
} catch (Exception e) { 
e.printStackTrace(); 
info = e.getMessage(); 
} 
} 
return info; 
| 
编码 完毕 , 找 一 台 支 持 NFC 的 手机 安装 测试 App, 启动 应 用 前 注意 开启 手机 的 NFC 功能 。 
然后 进入 App 测试 页 面 ， 拿 一 张 门 禁 卡 靠近 手机 背面 〈 门 禁 卡 不 一 定 是 卡片 ， 也 可 能 是 钥匙 
扣 模 样 ) ， 稍 等 片刻 便 会 读 取 并 显示 门禁 卡 的 基本 信息 ， 卡 片 信息 的 获取 界面 如 图 9-34 所 示 。 





请 将 卡片 靠近 手机 背面 
@ 读 取 小 区 门禁 卡 ”人 〇 读 取 北京 一 卡通 





卡片 的 序列 号 为 : 54DF13E4 
详细 信息 如 下 : 
卡片 类 型 : 传统 类 型 
扇 区 数量 : 16 
分 块 个 数 : 64 
存储 空间 : 1024 字 节 





图 9-34 NFC 手机 读 取 到 的 门禁 卡 信息 


当然 了 ，NFC 技术 不 只 包括 上 述 例子 的 NfcA 标准 ， 它 的 实际 应 用 也 不 仅 限 于 门禁 卡 ; 在 
市 场 前 景 更 加 广阔 的 小 额 支付 领域 ，NFC 技术 普遍 用 于 拿手 机 刷 公 交 ， 那 么 手机 读 取 公 交 卡 
就 运用 了 NFC 规范 的 另 一 种 子 标准 IsoDep。 对 于 IsoDep，Android 提供 了 同名 的 数据 格式 ， 
即 IsoDep 工具 类 ， 该 类 也 有 connect 方法 用 于 建立 连接 ， 有 close 方法 用 于 关闭 连接 。 但 是 公 
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交 卡 内 部 储存 的 数据 比较 复杂 ， 有 余额 、 时 间 、 刷 卡 明 细 等 等 信息 ， 这 可 不 是 几 个 get 方法 所 
能 搞定 的 。 为 此 IsoDep 类 专门 提供 了 transceive 方法 ， 只 需 开 发 者 通过 该 方法 输入 一 串 指令 ， 
系统 就 会 返回 字 节 形式 的 对 应 结果 数据 。 
于 是 乎 ， 如 果 开 发 者 能 够 获得 某 种 公交 卡 的 指令 编码 ， 以 及 相应 的 数据 格式 ， 利 用 手机 
读 取 公交 卡 信息 在 技术 上 就 行 得 通 了 。 写 到 这 里 , 笔者 想起 来 自己 有 好 几 年 没 去 北京 了 , 不 知 
道 公交 卡 还 有 多 少 钱 ， 正 巧 北京 一 卡通 的 编码 格式 是 公开 的 , 所 以 接 下 来 看 看 Android 代码 能 
解析 出 哪些 信息 。 详细 的 解析 代码 比较 元 长 ,这 里 不 贴 出 具体 代码 了 ， 有 兴趣 的 读者 可 参考 本 
书 附带 源码 中 device 模块 的 BusCardjava。 如 图 9-35 所 示 ， 这 是 一 张 如 假 包 换 的 北京 一 卡通 ， 
其 内 部 的 公交 余额 和 乘 车 记录 均 可 被 NFC 手机 读 取 , 读 出 来 的 一 卡通 详细 信息 如 图 9-36 所 示 。 








device 


请 将 卡片 靠近 手机 背面 
〇 读 取 小 区 门禁 卡 。 @ 读 取 北 京 一 卡通 


卡片 的 序列 号 为 : 498EA35F 
详细 信息 如 下 : 

卡 内 余额 : 0.20 元 

序列 号 : 1000751068465533 

版 本 号 : 01.0200 

有 效 期 : 2011.10.04 - 2015.09.20 

一 共 使 用 了 47 次 

刷卡 记录 如 下 : 
2013-10-25 13:10:19 消费 了 2.00 元 
2013-10-25 09:52:16 消费 了 0.40 元 
2013-10-20 19:04:34 消费 了 0.40 元 
2013-10-20 10:12:03 消费 了 0.40 元 
2013-10-20 09:22:43 消费 了 0.40 元 
2013-10-19 19:13:13 消费 了 2.00 元 
2013-10-19 17:51:47 消费 了 0.40 元 
2013-10-19 13:59:16 消费 了 0.40 元 
2013-10-19 11:55:03 消费 了 0.40 元 
2013-10-16 16:30:38 消费 了 2.00 元 





9-35 ”北京 市 政 交通 一 卡通 图 9-36 ”NFC 手 机 读 取 到 的 乘 车 信息 


原来 公交 卡 里 面 保存 的 数据 很 全 ， 不 但 查 出 了 还 剩 两 毛 钱 ， 而 且 连 笔者 前 几 年 在 北京 的 
乘 车 记录 都 一 清二 楚 。 乖乖 , 刷卡 时 间 竞 然 精 确 到 了 几时 几 分 几 秒 , 并 且 乘 坐 的 交通 方式 也 一 
目 了 然 ， 两 块 钱 坐 的 是 地 铁 ， 四 毛 钱 坐 的 是 公交 。 住 在 北京 和 去 过 北京 的 小 伙伴 们 ， 赶 紧 试 试 
你 们 的 一 卡通 能 不 能 读 得 出 来 。 


9.5.2 ”红外 遥控 


红外 遥控 是 一 种 无 线 控制 技术 ， 它 具有 功 耗 小 、 成 本 低 、 易 实现 等 诸多 优点 ， 因 而 被 各 
种 电子 设备 特别 是 家 用 电器 广泛 采用 , 像 日 常生 活 中 的 电视 遥控 器 、 空 调 遥 控 器 等 基本 都 采用 
红外 遥控 技术 。 

不 过 遥控 器 并 不 都 是 红外 遥控 ， 也 可 能 是 射频 和 遥控。 红外 遥控 使 用 近 红 外 光线 《频率 只 
有 几 万 赫 效 ) 作为 遥控 光源 ， 而 射频 遥控 使 用 超 高 频 电 磁 波 (频率 高 达 几 亿 赫 效 ) 作为 信号 载 
体 。 红 外 遥控 器 的 顶部， 有 的 灸 嵌 一 个 或 多 个 小 灯泡 ， 有 的 是 一 小 片 黑 色 盖子 ， 这 个 黑 盖 子 对 
红外 线 来 说 可 是 透明 的 ， 只 是 人 的 肉眼 看 不 穿 它 。 射 频 遥 控 器 的 项 部， 有 的 突出 一 根 天 线 ， 有 
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的 啥 都 没有 (其 实 发 射 器 包 在 盖子 里 面 ) 。 红 外 遥控 器 带 着 灯泡 就 像 一 支 手电 简 ， 红 外 光照 到 
哪里 ， 哪 里 的 电器 才 会 接收 响应 ， 这 决定 了 红外 遥控 的 3 个 特性 : 


(1) 禹 控 器 要 对 准 电器 才 有 反应 。 要 是 手电 简 没 照 到 这 儿 ， 那 肯定 是 黑 乎 乎 的 。 

(2) 于 控 器 不 能 距离 电器 太 远 ， 最 好 是 五 米 之 内 。 这 也 好 理解 ， 手 电筒 离 得 远 了 ， 照 到 
物体 上 的 光线 都 变 暗 了 。 

(3) 各 控 器 与 电器 之 间 不 能 有 障碍 物 。 你 能 想象 手电 简 发 出 来 的 灯光 会 穿 透 墙壁 吗 ? 


而 射频 遥控 器 正好 与 红外 的 特性 相反 ， 它 采用 超 高 频 电 磁 波 ， 所 以 信号 是 四 散 开 的 不 具 
备 方向 性 , 并 且 射 频 信号 的 有 效 距 离 可 以 长 达 数 十 米 , 末了 射频 信号 还 能 轻松 穿 透 非 金属 的 障 
得 物 。 红 外 遥控 和 射频 遥控 的 不 同 特性 决定 了 它们 各 自 擅长 的 领域 ， 红 外 遥控 看 似 局 限 很 多 ， 
其 实 正 适 用 于 家 用 电器 ， 和 否则 每 个 人 隔 着 墙 还 能 遥控 邻居 家 的 电器 ， 这 可 怎么 得 了 ; 射频 和 遥 控 
的 强大 抗 干扰 能 力 ， 更 适用 于 一 些 专业 的 电子 设备 。 因 为 红外 遥控 更 贴近 日 常生 活 ， 所 以 人 民 
大 众 购买 的 智能 手机 ， 自 然 配置 的 是 红外 遥控 了 《〈 有 的 手机 可 能 没 装 红外 发 射 器 ) 。 

听 起 来 装 了 红外 发 射 器 的 手机 ， 可 以 拿 来 当 遥 控 器 使 用 ， 只 要 一 部 手机 就 能 遥控 许多 家 
电 ， 这 不 是 什么 天 方 夜 谭 噢 ， 接 下 来 看 看 如 何在 App 开发 中 运用 红外 遥控 技术 。 

GT01 首先 要 在 App 工程 的 AndroidManifsstxml 中 补充 红外 权限 配置 ， 具 体 的 配置 例子 如 下 : 


<!-- 红外 遥控 --> 
<uses-permission android:name="android.permission.TRANSMIT IR"/> 
<!-- 仅 在 支持 红外 的 设备 上 运行 --> 
<uses-feature android:name="android.hardware.ConsumerIrManager" android:required="true" /> 
人 ER 其 次 在 代码 中 初始 化 红外 遥控 的 管理 器 , 注意 红外 遥控 功能 从 Android 4.4 之 后 才 开始 支持 。 
红外 遥控 对 应 的 管理 类 名 叫 ConsumerIrManager， 它 的 常用 方法 主要 有 三 个 ， 分 别 说明 如 下 : 


e。 hasIrEmitter 检查 设备 是 否 拥有 红外 发 射 器 。 返 回 true 表示 有 ， 返 回 false 表示 没有 。 

egetCarrierFrequencies ”获得 可 用 的 载波 频率 范围 。 

e transmit 发 射 红 外 信号 。 第 一 个 参数 为 信号 频率 ， 单 位 赫兹 (Hz) ， 家 用 电器 的 红外 频 
率 通 常 使 用 38000Hz; 第 二 个 参数 为 整 型 数组 形式 的 信号 格式 。 


注意 手机 的 红外 载波 频率 比较 固定 ， 大 多 处 于 30kHz 到 56kHz 之 间 ， 如 图 9-37 所 示 是 小 
米 6 手机 的 可 用 红外 频率 范围 。 














开关 扫地 机 器 人 获取 频率 范围 


当前 手机 的 红外 载波 频率 范围 为 : 
30000 - 30000 
33000 - 33000 
36000 - 36000 
38000 - 38000 
40000 - 40000 
56000 - 56000 





图 9-37 小 米 6 手 机 的 可 用 红外 频率 范围 
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下 面 是 红外 东 控 管理 器 的 初始 化 代码 例子 : 


private ConsumerIrManager cim; // 声明 一 个 红外 遥控 管理 器 对 象 
private void initInfrared() { 
/ 获取 系统 的 红外 遥控 服务 
cim = (ConsumerIrManager) getSystemService(Context. CONSUMER IR_SERVICE); 
让 (lcim.hasIrEmitter0){ / 判断 当前 设备 是 否 支持 红外 功能 
tv_infrared.setText(" 当 前 手机 不 支持 红外 遥控 "); 
} 
| 


CLT03 最 后 在 准备 发 射 遥 控 信号 之 时 ， 调 用 transmit 方法 就 把 红外 信号 发 出 去 了 。 


果真 如 此 简单 吗 ? 当然 不 是 , 这 里 面 的 玄机 全 在 transmit 方法 的 信号 格式 参数 上 面 。 想 一 
想 ， 家电 有 很 多 种 ， 每 种 家 电 又 有 好 几 个 品牌 ， 便 是 房间 里 的 某 个 家 电 ， 般 控 器 上 也 有 数 排 的 
按键 。 这 么 算 下 来 , 信号 格式 的 各 种 组 合 都 数 不 清 了 , 普通 开发 者 又 不 是 电器 厂商 的 内 部 人 员 ， 
要 想 破解 这 些 电 器 的 红外 信号 编码 ， 那 可 真是 比 登 天 还 难 。 

手工 破解 固然 不 容易 ， 却 也 并 非 没有 办 法 ， 现 在 有 一 种 红外 遥控 器 的 解码 仪 ， 可 到 淘宝 
上 面 购买 。 这 个 解码 仪 能 够 分 析 常 见 家 电 的 红外 遥控 信号 ， 下 面 两 种 除外 


(1) 空调 遥控 器 ， 空 调 的 控制 比较 复杂 ， 光 温度 就 可 能 调节 十 几 次 ， 难 以 破解 。 
(2) 灯光 遥控 器 ， 灯 本 身 发 光 发 热 ， 同 时 也 会 散发 大 量 红 外 线 ， 势 必 对 外 部 的 红外 信号 
造成 严重 干扰 ， 所 以 灯 只 能 采取 射频 遥控 器 。 

红外 解码 仪 是 家 电 维 修 人 员 的 必 备 仪器 ， 常 用 于 检 
测 遥 控 器 能 否 正 常 工作 ， 开 发 者 为 了 让 手机 实现 遥控 功 
能 ， 也 要 利用 解码 仪 捕捉 每 个 按键 对 应 的 红外 信号 。 接 

下 来 以 扫地 机 器 人 的 遥控 解码 为 例 ， 介 绍 如 何 通过 解码 
仪 获取 对 应 的 红外 遥控 指令 。 

先 将 扫地 机 器 人 的 遥控 器 对 准 解码 仪 正面 的 红外 接 
收 窗口 , 按 下 遥控 器 上 的 clean 键 (开始 扫地 /停止 扫地 )， 
此 时 解码 仪 的 分 析 结 果 如 图 9-38 所 示 。 

从 图 9-38 可 见 ，clean 键 的 红外 信号 由 三 部 分 组 成 ， 
分 别 是 用 户 码 4055、 数 据 码 44、 电 路 61212。 其 中 用 户 
码 表示 厂商 代号 ， 每 个 厂家 都 有 自己 的 唯一 代号 ; 数据 
码 表示 按键 的 编号 ， 不 同 的 数据 码 代表 不 同 的 按键 ; 电 
路 格式 表示 红外 信号 的 编码 协议 ， 每 种 协议 都 有 专门 的 ”图 9-38 解码 仪 对 遥控 器 指令 的 分 析 结 果 
指令 格式 。 比 如 说 电路 61212 对 应 的 是 NEC6121 协议 ， 

该 协议 的 红外 信号 编码 格式 为 : 引导 码 + 用 户 码 + 数据 码 + 数 据 反 码 + 结束 码 ， 其 中 引导 码 和 结 
东 码 都 是 固定 的 ， 数 据 反 码 由 数据 码 按 位 取 反 得 来 ， 真 正 变化 的 只 有 用 户 码 和 数据 码 。 

然而 解码 仪 获得 的 用 户 码 和 数据 码 并 不 能 直接 写 在 代码 中 ， 因 为 液晶 屏 上 的 编码 其 实 是 

十 六 进 制 数 , 需要 转换 为 二 进 制 数 才 行 。 例 如 用 户 码 4055， 对 应 的 二 进 制 数 为 0100 0000 0101 
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0101; 数据 码 44， 对 应 的 二 进 制 数 为 0100 0100， 按 位 取 反 得 到 数据 反 码 的 二 进 制 数 为 1011 
1011。 
可 是 前 述 的 transmit 方法 ， 参 数 要 传递 整 型 数组 形式 的 信号 ， 并 不 是 二 进 制 数 ， 这 意味 着 
二 进 制 数 还 得 转换 成 整 型 数组 .那么 整 型 数组 里 面 存放 的 到 底 是 些 什么 数据 呢 ?” 这 就 要 从 数字 
电路 中 的 电 平 说 起 了 。 电 平 是 “电压 平台 ”的 简称 ， 指 的 是 电路 中 某 一 点 电压 的 高 低 状 态 , 在 
数字 电路 中 常用 高 电 平 表示 “1”,， 用 低 电 平 表 示 “0”。 遥 控 器 发 射 红外 信号 之 时 ， 通 过 “560 
微 秒 低 电 平 +1680 微 秒 高 电 平 ”代表 “1”, 通过 “560 微 秒 低 电 平 +560 微 秒 低 电 平 ”代表 “0”。 
于 是 编写 Android 代码 的 时 候 ， 使 用 “560,1680” 表 示 二 进 制 的 1， 使 用 “560,560” 表 示 二 进 
制 的 0， 此 处 的 560 和 1680 只 是 大 概 的 数值 ， 也 可 使 用 580、600 替换 560， 或 者 使 用 1600、 
1650 蔡 换 1680。 
根据 数字 电路 的 电 平 规则 ， 用 户 码 4055 对 应 的 二 进 制 数 为 0100 0000 0101 0101， 转 换 成 
电 平 信号 就 变 成 了 “560,560, 560,1680, 560,560, 560,560, 560,560, 560,560, 560,560, 560,560， 
560,560, 560,1680, 560,560, 560,1680, 560,560, 560,1680, 560,560, 560,1680，”， 数 据 码 44 及 其 
数据 反 码 的 电 平 信号 依 此 类 推 。 再 加 上 NEC 协议 固定 的 引导 码 “9000,4500”， 以 及 结束 码 
“560,20000”， 即 可 得 出 前 面 clean 键 的 红外 信号 整 型 数组 ， 具 体 的 数组 数值 如 下 所 示 : 
int[] pattem = {9000,4500， / 开头 两 个 数字 表示 引导 码 
// 下 面 两 行 表 示 用 户 码 
560,560, 560,1680, 560,560, 560,560, 560,560, 560,560, 560,560, 560,560, 
560,560, 560,1680, 560,560, 560,1680, 560,560, 560,1680, 560.560, 560,1680, 
/ 下面 一 行 表示 数据 码 
560,560, 560,1680, 560,560, 560,560, 560,560, 560,1680, 560,560, 560,560, 
// 下 面 一 行 表示 数据 反 码 
560,1680, 560,560, 560,1680, 560,1680, 560,1680, 560,560, 560,1680, 560,1680, 
560,20000}; / 末尾 两 个 数字 表示 结束 码 


接着 在 App 代码 中 代入 上 述 的 信号 格式 数组 ， 即 调用 transmit 方法 传递 格式 参数 ， 示 例 
如 下 : 
// 发 射 指定 编码 格式 的 红外 信和 号。 普通 家 电 的 红外 发 


射频 率 一 般 为 38kHz 
cim.transmit(38000, pattern); 


运行 测试 App， 却 发 现 不 管 让 手机 发 送 多 少 次 的 
红外 信号 ， 扫 地 机 器 人 都 呆 若 木 鸡 ， 丝 毫 没有 反应 。 
这 是 咋 回 事 ? 奥秘 在 于 NEC 协议 只 规定 了 大 体 上 的 
编码 规则 , 实际 的 遥控 器 信号 在 整体 规则 内 略 有 调整 。 
之 前 提 到 的 解码 仪 ， 既 是 家 电 售后 的 检测 仪器 ， 也 可 
作为 App 开发 者 的 调试 工具 。 拿 起 手机 对 准 解码 仪 正 
面 的 接收 窗口 ， 点 击 按钮 发 送 红 外 信号 ， 解 码 仪 同步 
显示 分 析 后 的 信号 数据 ， 分 析 结果 如 图 9-39 所 示 。 
由 图 9-39 可 知 ， 此 时 手机 发 出 的 红外 信号 符合 ”图 939 解码 仪 对 手机 测试 指令 的 分 析 结果 
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NEC6121 协议 ， 只 不 过 用 户 码 变 成 了 02AA， 数 据 码 变 成 了 22。 把 这 两 个 码 数 翻 译 成 二 进 制 ， 
则 用 户 码 02AA 转 为 0000 0010 1010 1010, 数据 码 22 转 为 0010 0010。 回头 比较 遥控 器 的 解码 
数据 ， 遥 控 器 发 出 的 用 户 码 4055 对 应 0100 0000 0101 0101， 数 据 码 44 对 应 0100 0100。 看 起 
来 手机 与 遥控 器 的 信号 区 别 , 应 当 是 每 两 个 十 六 进 制 数 先 转 为 二 进 制 数 , 然后 倒 过 来 排列 , 也 
就 是 所 谓 的 逆序 编码 。 
找到 问题 的 症结 便 好 办 了 ， 数 学 上 有 负 负 得 正 ， 编 码 则 有 逆 逆 得 顺 。 既 然 4055 逆序 编码 
后 变 为 02AA， 那 么 02AA 逆序 编码 后 必 为 4055， 于 是 再 次 构造 用 户 码 02AA 以 及 数据 码 22 
的 电 平 信号 ， 更 改 后 的 红外 信号 数据 如 下 所 示 : 
int[] pattem = {9000,4500， // 开头 两 个 数字 表示 引导 码 
// 下 面 两 行 表示 用 户 码 
560,560, 560,560, 560,560, 560,560, 560,560, 560,560, 560,1680, 560,560, 
560,1680, 560,560, 560,1680, 560,560, 560,1680, 560,560, 560,1680, 560,560, 
// 下 面 一 行 表示 数据 码 
560,560, 560,560, 560,1680, 560,560, 560,560, 560,560, 560,1680, 560,560, 
// 下 面 一 行 表示 数据 反 码 
560,1680, 560,1680, 560,560, 560,1680, 560,1680, 560,1680, 560,560, 560,1680, 
560,20000}; / 末尾 两 个 数字 表示 结束 码 


重新 编译 运行 测试 App, 手机 依旧 对 准 解码 仪 ， 然 后 点 击 按钮 发 射 红外 信号 ， 解 码 仪 终 于 
正常 显示 用 户 码 4055、 数 据 码 4 了 。 这 时 再 将 手机 对 准 扫地 机 器 人 ， 点 击发 射 按钮 ， 机 器 人 
不 出 所 料 开 动 起 来 了 。 至 此 遥控 器 clean 键 的 红外 编码 正式 破解 完成 ， 其 他 按键 乃至 其 他 家 电 
遥控 器 的 红外 信号 编码 ， 均 可 通过 解码 仪 破译 得 到 。 

当然 ， 以 上 的 红外 信号 解析 办 法 ， 仅 限于 编码 规则 广泛 公开 的 NEC 协议 。 对 于 其 他 格式 
未 知 的 电路 协议 , 只 能 借助 于 更 专业 的 单片机 来 分 析 。 采用 红外 遥控 的 家 电 种 类 与 品牌 都 很 繁 
多 ， 前 人 已 经 对 它们 做 了 不 少 的 信号 破译 工作 ， 这 些 已 知 的 红外 信号 数据 详 见 网 址 
http://www.remotecentral.com/cgi-bin/ codes/， 里 面包 括 各 大 国外 家 电 品牌 的 信号 编码 ， 有 兴趣 
的 读者 可 参考 。 


9.5.3 蓝牙 BlueTooth 


蓝牙 是 一 种 短 距离 无 线 通信 技术 ， 它 由 爱立信 公司 于 1994 年 创制 ， 原 本 想 替 代 连 接 电信 
设备 的 数据 线 , 但 是 后 来 发 现 它 也 能 用 于 移动 设备 之 间 的 数据 传输 , 所 以 蓝牙 技术 在 手机 上 获 
得 了 长 足 发 展 。 

蓝牙 与 前 面 介绍 的 NFC 和 红外 都 是 无 线 技术 标准 ， 它 们 的 实际 应 用 场景 各 不 相同 ， 可 谓 
各 有 千秋 。NFC 主要 用 于 操作 简单 、 即 时 响应 的 刷卡 ， 红 外 主要 用 于 需要 按键 控制 、 价 格 低 
廉 的 家 电 遥 控 , 而 蓝牙 主要 用 于 两 部 设备 之 间 复 杂 且 大 量 的 数据 传输 ,NFC、 红 外 和 蓝牙 三 者 
之 间 的 详细 技术 参数 对 比 参 见 表 9-12。 
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表 9-12 NFC、 红 外 和 蓝牙 的 技术 参数 对 比 

















对 比 项 有 效 距 离 传输 速度 连接 建立 时 间 ”| 使 用 频率 范围 
NFC <=0.Im 最 大 53KBAs <0.1s 13.56MHz 
红外 数据 传输 一 Im 快速 500KB/s 0.5s 38kHz 

家 电 遥 控 <=10m 慢 速 15KB/s 
蓝牙 2.0 | =10m 最 大 375KB/s 6s 2400MHz 
BLE (蓝牙 40 及 以 上 版 本 ) | <=100m 最 大 3MB/s 2s 2400MHz 








因为 手机 内 部 的 通信 芯片 一 般 同 时 集成 了 2G/3G/4G、WiFi 和 蓝牙 ， 所 以 蓝牙 功能 已 经 是 
智能 手机 的 标 配 了 。 若 想 进 行 蓝 牙 方面 的 开发 ， 需 要 在 App 工程 的 AndroidManifest.xml 中 补 
充 下 面 的 权限 配置 : 

<!-- 蓝牙 --> 

<uses-permission android:name="android.permission.BLUETOOTH ADMIN" /> 
<uses-permission android:name="android.permission.BLUETOOTH" /> 

<!-- 仅 在 支持 BLE 即 蓝牙 4.0) 的 设备 上 运行 --> 

<uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/> 
<!-- 如 果 Android 6.0 蓝牙 搜索 不 到 设备 ， 需 要 补充 下 面 两 个 权限 --> 
<uses-permission android:name="android.permission.ACCESS_FINE LOCATION" /> 
<uses-permission android:name="android.permission.ACCESS_COARSE _ LOCATION" /> 


与 NFC、 红 外 类 似 ，Android 也 提供 了 蓝牙 模块 的 管理 工具 ， 名 叫 BluetoothAdapter， 虽 
然 通常 把 BluetoothAdapter 翻译 为 “蓝牙 适配器 ”， 其 实 它 干 的 是 管理 器 的 活 。 下 面 是 
BluetoothAdapter 类 常用 的 方法 说 明 。 


。 getDefaultAdapter: 获取 默认 的 蓝牙 适配器 。 该 方法 为 静态 方法 。 

getState: 获取 蓝牙 的 开关 状态 。STATE_ON 表示 已 开启 ，STATE_TURNING_ON 表示 
正在 开启 ，STATE_OFF 表示 已 关闭 ，STATE_TURNING_OFF 表示 正在 关闭 。 
enable: 启用 蓝牙 功能 。 

disable: 禁用 蓝牙 功能 。 

isEnabled: 判断 蓝牙 功能 是 否 启用 。 返 回 true 表示 已 启用 ， 返 回 false 表示 未 启用 。 
getBondedDevices: 获取 已 配对 的 设备 集合 。 

getRemoteDevice: 根据 设备 地 址 获取 远程 的 设备 对 象 。 

startDiscovery: 开始 搜索 周围 的 蓝牙 设备 。 

cancelDiscovery: 取消 搜索 周围 的 蓝牙 设备 。 

isDiscovering: 判断 是 否 正 在 搜索 周围 的 蓝牙 设备 。 


由 于 BluetoothAdapter 实际 干 了 管理 器 的 活 ， 因 此 Android 从 4.3 开始 引入 了 正牌 的 管理 
器 BluetoothManager， 调 用 BluetoothManager 对 象 的 getAdapter 也 可 获得 蓝牙 适配器 。 但 
Android 4.3 对 蓝牙 的 增强 补充 ,不 只 是 添加 BluetoothManager， 更 是 为 了 支持 最 新 的 BLE 〈 即 
蓝牙 低能 耗 “Bluetooth Low Energy”) ，BLE 对 应 的 是 蓝牙 4.0 及 以 上 版 本 。 因 为 BLE 采取 
非常 快速 的 连接 方式 ， 所 以 平时 处 于 “ 非 连接 ”状态 ， 此 时 链 路 两 端 仅 是 知晓 对 方 ， 只 有 在 必 


See ee ge @ @ 
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要 时 才 开 启 链 路 ， 完 成 传输 后 会 尽快 关闭 链 路 。BLE 技术 与 之 前 版 本 的 蓝牙 标准 相 比 ， 主 要 
有 三 个 方面 的 改进 : 更 省 电 、 连 接 速 度 更 快 、 传 输 距 离 更 远 。 

接 下 来 通过 一 个 检测 蓝牙 设备 并 配对 的 例子 ， 介 绍 如 何在 App 开发 中 运用 蓝牙 技术 。 不 
要 小 看 这 个 例子 ， 简 简单 单 的 功能 可 得 分 成 4 个 步骤 : 初始 化 、 启 用 蓝牙 、 搜 索 蓝 牙 设备 、 与 
指定 设备 配对 ， 下 面 分 别 进行 详细 说 明 。 


1. 初始 化 蓝牙 适配器 


如 果 App 会 用 到 BLE 的 特性 ， 则 需 增加 对 Android 版 本 的 判断 ， 对 于 4.3 及 以 上 版 本 要 
从 BluetoothManager 中 获取 蓝牙 适配器 。 如 果 仅 仅 是 普通 的 蓝牙 连接 , 则 调用 getDefaultAdapter 
获取 蓝牙 适配器 就 行 了 。 初 始 化 蓝牙 适配器 的 代码 示例 如 下 : 
private BluetoothAdapter mBluetooth; // 声明 一 个 蓝牙 适配器 对 象 
// 初始 化 蓝牙 适配器 
private void initBluetooth() { 
/Android 从 4.3 开始 增加 支持 BLE 技术 〈 即 蓝牙 4.0 及 以 上 版 本 ) 
让 (Build.VERSION.SDK INT 关 Build.VERSION_CODES.JELLY BEAN_MR2) { 
/ 从 系统 服务 中 获取 蓝牙 管理 器 
BluetoothManager bm = (Bluetooth Manager) 
getSystemService(Context.BLUETOOTH SERVICE):; 
mBluetooth = bm.getAdapter(); 
}else{ 
/ 获取 系统 默认 的 蓝牙 适配器 
mBluetooth = BluetoothAdapter.getDefaultAdapter(); 


} 
if (mBluetooth 一 nulD) { 


Toast.makeText(this, "本 机 未 找到 蓝牙 功能 ", Toast.LENGTH_SHORT).show0; 
finish(); 


| 
2. 启用 蓝牙 功能 
虽然 BluetoothAdapter 提供 了 enable 方法 用 于 启用 蓝牙 功能 , 但 是 该 方法 并 不 允许 外 部 发 


现 本 设备 ， 所 以 等 于 没 用 。 实 际 开发 中 要 弹 窗 提示 用 户 ， 是 否 允 许 其 他 设备 检测 到 自身 ， 弹 窗 
代码 如 下 所 示 : 
// 弹出 是 否 允 许 扫描 蓝牙 设备 的 选择 对 话 框 


Intent intent = new Intent(BluetoothAdapter. ACTION_ REQUEST DISCOVERABLE); 
startActivityForResult(intent, mOpenCode); 


蓝牙 权限 的 选择 对 话 框 如 图 9-40 所 示 。 
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某 个 应 用 想 要 打开 蓝牙 ， 以 便 其 他 设 
备 在 120 秒 内 可 检测 到 您 的 手机 。 


拒绝 允许 





9-40 蓝牙 权限 的 选择 对 话 框 


由 于 图 9-40 的 选择 弹 窗 上 面 可 选择 “允许 ”还 是 “拒绝 ”， 因 此 代码 中 要 重 写 
onActivityResult 函数 ， 在 该 函数 中 判断 蓝牙 权限 的 选择 结果 。 下 面 是 判断 权限 选择 的 代码 : 
private int mOpenCode = 1; / 是 否 允 许 扫描 蓝牙 设备 的 选择 对 话 框 返回 结果 代码 
protected void onActivityResult(int requestCode, int resultCode, Intent intent) { 
super.onActivityResult(requestCode, resultCode, intent); 
让 (requestCode 一 mOpenCode) {// 来 自 允 许 蓝 牙 扫描 的 对 话 框 
// 延迟 50 毫秒 后 启动 蓝牙 设备 的 刷新 任务 
mHandler.postDelayed(mRefresh, 50); 
if (resultCode 一 RESULT_ OK) { 
Toast.makeText(this, "允许 本 地 蓝牙 被 附近 的 其 他 蓝牙 设备 发 现 "， 
Toast.LENGTH_ SHORT).show(0); 
} else if (resultCode 一 RESULT_ CANCELED) { 
Toast.makeText(this, "不 允许 蓝牙 被 附近 的 其 他 蓝牙 设备 发 现 ", 
ToastLENGTH_ SHORT).show(0); 


3. 搜索 周围 的 蓝牙 设备 


蓝牙 功能 打开 之 后 ， 就 能 调用 startDiscovery 方法 去 搜索 周围 的 蓝牙 设备 了 。 不 过 因为 搜 
索 动 作 是 个 异步 的 过 程 ，startDiscovery 方法 并 不 直接 返回 搜索 发 现 的 设备 结果 ， 而 是 通过 广 
播 BluetoothDevice.ACTION_FOUND 返回 新 发 现 的 蓝牙 设备 。 所 以 页 面 代码 需要 注册 一 个 蓝 
牙 搜索 结果 的 广播 接收 器 ， 在 接收 器 中 解析 蓝牙 设备 信息 ， 再 把 新 设备 添加 到 蓝牙 设备 列表 。 
下 面 是 蓝牙 搜索 接收 器 的 注册 、 注 销 ， 以 及 内 部 逻辑 处 理 的 代码 例子 : 
Private void beginDiscovery() { 
// 如 果 当 前 不 是 正在 搜索 ， 则 开始 新 的 搜索 任务 
if (ImBluetooth.isDiscovering()) { 
mBluetooth.startDiscovery0; // 开始 扫描 周围 的 蓝牙 设备 
9 
b 


protected void onStartO { 
super.onStart(); 
// 需要 过 滤 多 个 动作 ， 则 调用 IntentFilter 对 象 的 addAction 添加 新 动作 
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IntentFilter discoveryFilter = new IntentFilter(); 
discoveryFilter.addAction(BluetoothDevice.ACTION FOUND); 
/ 注册 蓝牙 设备 搜索 的 广播 接收 器 
TegisterReceiver(discoveryReceiver discoveryFilter); 


protected void onStopO) { 
super.onStop(); 
/ 注销 蓝牙 设备 搜索 的 广播 接收 器 
unregisterReceiver(discoveryReceiver); 


} 


// 蓝牙 设备 的 搜索 结果 通过 广播 返回 
private BroadcastReceiver discoveryReceiver = new BroadcastReceiver() { 
public void onReceive(Context context, Intent intent) { 
String action = intent.getAction(); 
/ 获得 已 经 搜索 到 的 蓝牙 设备 
让 (action.equals(BluetoothDevice.ACTION_FOUND)) { V 发 现 新 的 蓝牙 设备 
BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE); 
refreshDevice(device); / 将 发 现 的 蓝牙 设备 加 入 到 设备 列表 


IB 


搜索 到 的 蓝牙 设备 可 能 会 有 多 个 ， 每 发 现 一 个 新 设备 都 会 收 到 一 次 发 现 广播 ， 这 样 设备 
列表 是 动态 刷新 的 。 搜 索 完 成 的 蓝牙 设备 列表 界面 如 图 9-41 和 图 9-42 所 示 , 其 中 图 9-41 为 A 
手机 的 设备 列表 ， 图 9-42 为 B 手机 的 设备 列表 。 










GL ss 蓝牙 设备 搜索 完成 GY )mer 正在 搜索 蓝牙 设备 


点 击 设备 项 开始 配对 , 再 点 击 取消 配对 点 击 设备 项 开始 配对 ， 再 点 击 取消 配对 
名 称 地 址 状态 名 称 地 址 状态 
DOOV V3 00:0C:E7:61:5E:98 。 未 绑 定 小 米 手 机 D8:63:75:DA:17:5C ”未 绑 定 
XMFHZ02 F4:4E:FD:74:61:4E 。” 未 绑 定 DOOV V3 00:0C:E7:61:5E:98 ”未 绑 定 








Lenovo A808t AC:38:70:3F:B6:6A ”未 绑 定 





图 9-41 A 手机 的 蓝牙 设备 列表 图 942 B 手机 的 蓝牙 设备 列表 
4. 与 指定 的 蓝牙 设备 配对 


注意 到 新 发 现 的 设备 状态 是 “未 绑 定 ”， 这 意味 着 当前 手机 并 不 能 跟 对 方 设备 进行 数据 
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交互 。 只 有 新 设备 是 “已 绑 定 ”状态 , 才能 与 当前 手机 传输 数据 。 蓝 牙 设 备 的 “未 绑 定 ”与 “已 
绑 定 ”， 区 别 在 于 这 两 部 设备 之 间 是 否 成 功 配对 了 ， 而 配对 操作 由 BluetoothDevice 类 管理 。 
下 面 是 BluetoothDevice 类 的 常用 方法 说 明 。 


e@ getName: 获取 设备 的 名 称 。 

。 getAddress: 获取 设备 的 MAC 地 址 。 

e@ getBondState: 获取 设备 的 配对 状态 。BOND_NONE 表示 未 绑 定 ，BOND_BONDING 表 

示 正 在 绑 定 ，BOND_BONDED 表示 已 绑 定 。 

e@ createBond: 建立 该 设备 的 配对 信息 。 该 方法 为 隐藏 方法 ， 需 要 通过 反射 调用 。 

e@ removeBond: 移 除 该 设备 的 配对 信息 。 该 方法 为 隐藏 方法 ， 需 要 通过 反射 调用 。 

从 上 面 的 方法 说 明 可 以 看 出 ， 搜 索 获 得 新 设备 后 ， 即 可 调用 设备 对 象 的 createBond 方法 
建立 配对 。 但 配对 成 功 与 否 的 结果 同样 不 是 立即 返回 的 , 因为 系统 会 弹出 配对 确认 框 供用 户 选 
择 ， 正 如 图 9-43 和 图 9-44 所 示 的 那样 ， 其 中 图 9-43 是 A 手机 上 的 配对 弹 窗 ， 图 9-44 是 B 手 
机 上 的 配对 弹 窗 。 





要 与 Lenovo A808t 配 对 吗 ? 蓝牙 配对 请 求 


要 与 以 下 设备 配对 ; 


蓝牙 配对 码 


408763 JF 


允许 Lenovo A808t 访 问 您 的 通讯 录 和 请 确保 其 显示 的 配对 密 钥 为 : 
通话 记录 408763 


取消 





9-43 和 A 手机 上 的 蓝牙 配对 弹 窗 图 9-44 B 手机 上 的 蓝牙 配对 弹 窗 


只 有 用 户 在 两 部 手机 都 选择 了 “配对 ”按钮 ， 才 算是 双方 正式 搭配 好 了 。 由 于 配对 请 求 
需要 在 界面 上 手工 确认 , 因此 配对 结果 只 能 通过 异步 机 制 返回 , 此 处 的 结果 返回 仍然 采取 广播 
形式 ， 即 系统 会 发 出 广播 BluetoothDevice.ACTION_BOND_STATE_CHANGED 通知 App。 故 
而 前 面 第 三 步 的 广播 接收 器 得 增加 过 滤 配 对 状态 的 变更 动作 , 接收 器 内 部 也 要 补充 更 新 蓝牙 设 
备 的 配对 状态 了 。 修 改 后 的 广播 接收 器 相关 代码 片段 如 下 所 示 : 


protected void onStartO { 
super.onStart(); 
/ 需要 过 滤 多 个 动作 ， 则 调用 IntentFilter 对 象 的 addAction 添加 新 动作 
IntentFilter discoveryFilter = new IntentFilterO; 
discoveryFilter.addAction(BluetoothDevice.ACTION_ FOUND); 
// 增加 配对 状态 的 变更 动作 
discoveryFilter.addAction(BluetoothDevice. ACTION_BOND STATE CHANGED); 
/ 注册 蓝牙 设备 搜索 的 广播 接收 器 
TegisterReceiver(discoveryReceiver discoveryFilter); 
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/ 蓝牙 设备 的 搜索 结果 通过 广播 返回 
Private BroadcastReceiver discoveryReceiver = new BroadcastReceiver() { 
public void onReceive(Context context Intent intent) { 
String action = intent.getAction(); 
/ 获得 已 经 搜索 到 的 蓝牙 设备 
证 (action.equals(BluetoothDevice.ACTION_ FOUND)) { V 发 现 新 的 蓝牙 设备 
BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice. EXTRA DEVICE); 
refreshDevice(device); / 将 发 现 的 蓝牙 设备 加 入 到 设备 列表 
} else if (action.equals(BluetoothDevice. ACTION BOND STATE_ CHANGED)){ 
BluetoothDevice device = intentgetParcelableExtra(BluetoothDevice.EXTRA_DEVICE); 
/ 更 新 蓝牙 设备 的 配对 状态 
if (device.getBondState() 一 BluetoothDevice. BOND BONDING) { 
tv_discovery.setText(" 正 在 配对 " + device.getName()); 
} else if (device.getBondState() 一 BluetoothDevice. BOND BONDED) { 
tv_discovery.setText(" 完 成 配对 " + device.getName()); 
} else if (device.getBondState() 一 BluetoothDevice.BOND NONE) { 
tv_discovery.setText(" 取 消 配对 "+ device.getName()); 
1 


} 
让 
两 部 手机 配对 完毕 ， 分 别 刷新 自己 的 设备 列表 页 面 ， 将 对 方 设备 的 配对 状态 改 为 “已 绑 
定 ”, 然后 它 俩 就 可 以 眉目 传情 ,传递 小 纸 条 什么 的 了 。 更 新 状态 后 的 设备 列表 界面 如 图 9-45 
和 图 9-46 所 示 ， 其 中 图 9-45 为 A 手机 的 设备 列表 ， 图 9-46 为 B 手机 的 设备 列表 。 








@L ss 蓝牙 设备 搜索 完成 


点 击 设备 项 开始 配对 , 再 点 击 取消 配对 
名 称 地 址 状态 












DOOV V3 00:0C:E7:61:5E:98 ”未 绑 定 


XMFHZ02 F4:4E:FD:74:61:4E ”未 绑 定 





Lenovo A808t AC:38:70:3F:B6:6A 已 绑 定 





9-45 ”A 手机 的 设备 列表 


@ J 正在 搜索 蓝牙 设备 


点 击 设备 项 开始 配对 ， 再 点 击 取消 配对 
名 称 地 址 状态 


D8:63:75:DA:17:5C ”已 绑 定 








00:0C:E7:61:5E:98 ”未 绑 定 





图 9-46 B 手机 的 设备 列表 
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9.6 ”实战 项 目 : 仿 微 信 的 发 现 功能 


本 章 涉 及 的 知识 点 比较 庞杂 ， 前 面 介绍 的 大 多 是 基础 功能 应 用 ， 很 少 有 实际 业务 的 使 用 
说 明 。 本 节 的 实战 项 目 谈 谈 手机 的 设备 功能 在 商用 App 中 的 具体 应 用 ， 让 读者 站 在 用 户 角度 
对 设备 操作 有 一 个 感性 认识 ， 如 果 想 做 一 个 受 欢迎 的 App, 不 仅 需要 钻研 技术 , 更 要 贴近 用 户 
生活 ， 研 发 易 用 、 好 用 、 值 得 用 的 App。 


9.6.1 设计 思 


微 信 的 用 户 量 巨 大 ， 不 少 小 功能 都 很 人 性 化 ， 比 如 发 现 频道 ， 如 图 9-47 所 示 。 发 现 频道 
提供 的 小 功能 包括 扫 一 扫 、 摇 一 摇 、 看 一 看 、 附 近 的 人 、 漂 流 瓶 等 ， 如 附近 的 人 、 漂 流 瓶 等 需 
要 多 人 参与 的 功能 不 纳入 本 次 实战 项 目 , 扫 一 扫 与 摇 一 摇 相 对 纯粹 ， 加 入 实战 项 目 当 中 。 看 一 
看 本 来 是 看 新 闻 ， 不 过 这 跟 本 章 没什么 关联 ， 还 是 改 成 听 一 听 ， 也 加 入 到 实战 项 目 中 。 

另外 ， 支 付 宝 原来 有 一 个 听 一 听 功 能 也 很 有 名 。2016 年 前 的 除夕 夜 ， 全 民 开 局 听 一 听 疯 
抢 五 福 卡 ， 这 个 场景 片段 还 登 上 了 当年 的 春晚 荧屏 。 








现在 综合 微 信 与 支付 宝 的 几 个 小 功能 ， 组 成 本 章 的 实战 项 目 一 一 “ 仿 微 信 的 发 现 功能 ”。 
该 功能 内 含 4 个 模块 ， 分 别 是 扫 一 扫 、 摇 一 摇 、 啉 一 啉 和 听 一 听 ， 入 口 效 果 如 图 9-48 所 示 。 
名。 扫 一 扫 
生 ” 提 一 摇 
扫 一 扫 ( 扫描 二 维 码 ) 
看 看 摇 一 摇 ( 博 饼 抽 大 奖 ) 
其 “了 NG 的 人 啉 一 只 ( 卫星 浑 天 仪 ) 
过 漂流 瓶 听 一 听 ( 蓝牙 播音 乐 ) 
图 9-47 ” 微 信 的 发 现 频道 截图 图 9-48 仿 微 信 的 发 现 功 能 页 面 截 图 


下 面 分 别 说 明 这 4 个 模块 将 要 实现 的 功能 。 
1. 扫 一 扫 (扫描 二 维 码 ) 


该 模块 与 微 信 的 “ 扫 一 扫 ” 基 本 类 似 ， 通 过 扫描 二 维 码 图 片 识别 二 维 码 携带 的 字符 串 信 
息 。Android 中 的 二 维 码 扫描 可 用 谷歌 的 zxing 工具 包 结合 zxing 的 开源 框架 完成 扫 码 与 识别 
操作 。 扫 一 扫 的 效果 如 图 9-49 所 示 ， 此 时 手机 在 进行 图 像 识别 。 
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图 9-49 扫 一 扫 (扫描 二 维 码 ) 的 初始 界面 


2. 摇 一 摇 〈 博 饼 抽 大 奖 ) 


微 信 的 “ 摇 一 摇 ” 可 以 摇 人 、 摇 歌曲 、 摇 电视 ， 我 们 另辟蹊径 ， 做 一 个 摇 贷 子 的 游戏 一 
“中 秋 博 饼 ”。300 多 年 前 ， 民 族 英 雄 郑 成 功率 军 驻扎 在 厦门 进行 抗 清 活动 ， 每 逢 中 秋 佳 节 ， 
为 宽慰 士兵 的 思乡 之 情 ， 发 明了 名 为 “ 博 饼 ”的 摇 仍 子 游戏 ， 依 据 不 同 的 幸运 点 数 判定 不 同 的 
中 奖级 别 。 经 过 几 百 年 的 流传 ， 中 秋 节 博 饼 的 习俗 已 经 广泛 流传 于 韶 台 两 地 与 东南 亚 。 本 实战 
项 目 通 过 摇 手 机 触发 摇 骨 子 的 动作 ， 进 而 计算 每 次 的 中 奖 结果 。 博 饼 抽 大 奖 的 效果 如 图 9-50 
所 示 ， 这 是 博 饼 游戏 的 初始 界面 。 


3. 吻 一 味 〈 卫 星 浑 天 仪 ) 


浑 天 仪 为 东汉 科学 家 张衡 发 明 ， 用 于 观测 天 象 ， 日 月 星辰 皆 可 在 浑 天 仪 上 找到 对 应 的 位 
置 。 随 着 现代 科技 的 发 展 , 我 们 已 经 不 满足 于 自古 以 来 就 有 的 日 月 星 展 , 而 是 把 现在 的 科技 成 
果 展 示 出 来 ,前 面 提 到 , 手机 定位 的 一 大 手段 是 卫星 定位 , 既然 人 造 卫 星 能 够 发 现 手机 的 位 置 ， 
反 过 来 手机 也 能 发 现 人 造 卫 星 的 方位 ， 把 手机 (导航 芯片 ) 监测 到 的 卫星 逐个 标记 在 罗盘 上 岂 
不 构成 了 一 个 卫星 浑 天 仪 ? 卫星 浑 天 仪 的 效果 如 图 9-51 所 示 ， 一 开始 只 有 一 个 罗盘 ， 具 体 的 
卫星 信息 还 有 待 在 代码 中 获取 ， 并 显示 到 罗盘 上 。 





扬 一 摇 ， 博 饼 中 大 奖 














图 9-50 摇 一 摇 〈 博 饼 抽 大 奖 ) 的 初始 界面 图 9-51 啉 一 啉 (卫星 浑 天 仪 ) 的 初始 界面 
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4. 听 一 听 〈 蓝 牙 播 音乐 


平常 手机 播放 音乐 ， 要 么 由 手机 自己 播放 ， 要 么 插 上 耳机 播放 。 然 而 手机 自身 的 音量 小 ， 
而 且 音色 也 差 ; 至 于 耳机 还 得 塞 进 耳 杀 ， 长 期 损害 听力 不 说 ， 拖 着 一 根 音频 线 也 多 有 不 便 。 于 
是 A2DP 技术 应 运 而 生 ，A2DP 的 全 称 是 “Advanced Audio Distribution Profile”， 意 思 是 蓝牙 
音频 传输 模型 协定 ， 即 利用 蓝牙 功能 播放 音频 。 那 么 播放 音频 的 介质 ， 既 可 以 是 蓝牙 耳机 ， 也 
可 以 是 蓝牙 音箱 ， 当 然 消费 者 更 青睐 使 用 蓝牙 音箱 播放 音乐 ， 近 几 年 智能 音箱 就 很 火 。 

分 析 实战 项 目 4 个 模块 的 功能 大 致 包含 本 章 哪些 知识 点 ? 读者 肯定 能 找到 以 下 5 点 。 

(1) 相机 类 Camera: 扫描 二 维 码 需要 摄像 头 支持 ， 必 然 用 到 Camera。 

(2) 加 速度 传感器 SensorManager: 前 面 介绍 加 速度 传感器 时 已 经 提 到 它 通常 用 于 摇 一 摇 。 

(3) 定位 管理 器 LocationManager: 无 论 是 根据 卫星 找 手 机 的 位 置 ， 还 是 通过 手机 监测 卫 
星 的 位 置 ， 都 会 用 到 定位 功能 。 

(4) 媒体 播放 器 MediaPlayer: 好 几 个 场景 需要 播放 声音 ， 比 如 二 维 码 识别 完毕 的 “ 哗 ” 
声 ， 摇 一 摇 的 摇 人 般 子 声 ， 听 一 味 的 “ 听 味 ” 声 ， 以 及 音乐 播放 ， 这 些 都 要 用 MediaPlayer 播音 。 

(5) 蓝牙 BlueTooth: 手机 借助 蓝牙 功能 连接 蓝牙 音箱 ， 然 后 再 由 蓝牙 音箱 播音 。 

涉及 的 知识 点 不 算 多 ， 但 也 基本 涵盖 了 每 节 的 代表 技术 。 
9.6.2 ”小 知识 :全球 卫星 导航 系统 


卫星 导航 是 高 科技 的 航天 技术 ， 目 前 联合 国 认可 的 全 球 卫星 导航 系统 有 4 个 ， 分 别 是 美国 
的 GPS、 俄罗斯 的 格 洛 纳 斯 、 中 国 的 北斗 和 欧洲 的 伽利略 ， 其 中 真正 投入 商用 的 只 有 前 3 个 。 


(1) 美国 的 GPS: GPS 是 Global Positioning System (全 球 定位 系统 ) 的 简称 ， 于 1964 
年 投入 使 用 。 到 1993 年 ， 包 含 24 颗 卫星 的 GPS 系统 完成 组 网 。 

(2) 俄罗斯 的 格 洛 纳 斯 : 格 洛 纳 斯 (GLONASS) 是 俄语 对 全 球 卫星 导航 系统 Global 
Navigation Satellite System 的 简称 , 该 系统 于 2007 年 开始 运营 , 并 在 2011 年 完成 24 颗 卫星 的 
组 网 。 

(3) 中 国 的 北斗 : 北斗 (BeiDou Navigation Satellite System，BDS) 是 中 国 自行 研制 的 全 
球 卫星 导航 系统 ， 是 继 美 国 GPS、 俄 罗斯 格 洛 纳 斯 之 后 第 3 个 成 熟 的 卫星 导航 系统 。 北 斗 在 
2007 年 开始 提供 定位 服务 ，2012 年 完成 16 颗 卫星 的 亚太 地 区 组 网 。2017 年 11 月 ， 北 斗 第 三 
代 导 航 卫星 顺利 升 空 ， 标 志 着 北斗 系统 的 全 球 组 网 正式 开始 。2018 年 ， 北 斗 将 再 发 射 18 颗 卫 
星 ， 计 划 在 2020 年 之 前 部 署 完成 第 三 代 的 35 颗 卫 星 ， 届 时 北斗 可 以 像 GPS 一 样 覆 盖 全 球 。 

(4) 欧洲 的 伽利略 : 伽利略 卫星 导航 系统 (Galileo Satellite Navigation System) 是 由 欧盟 
研制 和 建立 的 全 球 卫 星 导 航 定位 系统 ， 它 于 2013 年 完成 4 颗 卫星 的 初步 组 网 ， 且 退 至 2016 
年 底 才 开始 提供 区 域 定位 服务 ， 该 系统 计划 于 2020 年 完成 30 颗 卫 星 的 全 球 覆 盖 。 


目前 ， 智 能 手机 一 般 都 内 置 GPS 的 导航 芯片 ， 只 有 部 分 中 、 高 端 手机 同时 内 置 格 洛 纳 斯 
与 北斗 的 导航 芯片 。 

要 想 获取 天 上 的 卫星 信息 ， 得 调用 定位 管理 器 LocationManager 对 象 的 addGpsStatusListener 
方法 添加 定位 状态 监听 器 ， 该 监听 器 需 实现 GpsStatus.Listener 接口 的 onGpsStatusChanged 方 
法 ， 该 方法 提供 了 定位 状态 变化 的 事件 信息 ， 事 件 类 型 的 取 值 说 明 见 表 9-13。 
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表 9-13 GPS 事件 类 型 的 取 值 说 明 

















GpsStatus 类 的 事件 类 型 说 明 

GPS EVENT STARTED GPS 功能 开启 
GPS_EVENT _ STOPPED GPS 功能 停止 
GPS_EVENT FIRST FIX 首次 定位 

GPS EVENT SATELLITE STATUS 周期 地 报告 卫星 状态 


其 中 ， 最 后 一 个 卫星 状态 报告 事件 可 以 获得 监测 到 的 卫星 信息 ， 一 旦 捕获 该 事件 ， 即 可 
调用 LocationManager 对 象 的 getGpsStatus 方法 获得 当前 的 定位 状态 信息 GpsStatus， 再 调用 
GpsStatus 对 象 的 getSatellites 方法 获得 本 次 监测 到 的 卫星 列表 ， 卫 星 列表 是 一 个 GpsSatellite 
队列 ， 详 细 的 卫星 信息 可 通过 GpsSatellite 对 象 的 以 下 方法 获得 。 


e getPm: 获取 卫星 的 伪 随 机 码 ， 可 以 认为 是 卫星 的 编号 。 
e@ ”getAzimuth: 获取 卫星 的 方位 角 。 
e@ getElevation: 获取 卫星 的 仰角 .。 
e@ getSnr: 卫星 的 信 噪 比 ， 即 信和 号 强 能 。 
e@ hasAlmanac: 卫星 是 否 有 年 历 表 。 
e@ hasEphemeris: 卫星 是 否 有 星 历 表 。 
e@ usedInFix: 卫星 是 否 被 用 于 近期 的 GPS 修正 计算 。 
言 息 中 ， 对 确定 卫星 位 置 有 用 的 主要 有 3 个 ， 分 别 是 卫星 编号 (用 于 确定 卫星 的 
星 的 方位 角 〈 用 于 确定 卫星 的 方向 ) 和 卫星 的 仰角 (用 于 确定 卫星 的 远近 距离 》。 
下 面 是 获取 导航 卫星 信息 的 监听 器 代码 片段 : 
1/ 定义 一 个 导航 状态 监听 器 
private GpsStatus.Listener mStatusListener = new GpsStatus.Listener() { 





/ 在 卫星 导航 系统 的 状态 变更 时 触发 
public void onGpsStatusChanged(int event) { 
// 获取 卫星 定位 的 状态 信息 
GpsStatus gpsStatus = mLocationMgr.getGpsStatus(null); 
switch (event) { 
case GpsStatus.GPS_EVENT_SATELLITE_STATUS: // 周期 的 报告 卫星 状态 
/ 得 到 所 有 收 到 的 卫星 信息 ， 包 括 卫星 的 高 度 角 、 方 位 角 、 信 噪 比 和 卫星 编号 
Tterable<GpsSatellite> satellites = gpsStatus.getSatellites(); 
for (GpsSatellite satellite : satellites) { 
Satellite item = new Satellite(); 
item.seq = satellite.getPrn(); / 卫星 的 伪 随 机 码 ， 可 以 认为 就 是 卫星 的 编号 
item.signal = Math.round(satellite.getSnr()); / 卫星 的 信 噪 比 
item.elevation = Math round(satellite.getElevation0); / 卫星 的 仰角 
item.azimuth = Math.round(satellite.getAzimuth0); / 卫星 的 方位 角 
item.time = DateUtil.getNowDateTime(); 
if(item.seq <= 64 | (item.seq >= 120 && item.seq <= 138)) { /1/ 分 给 美国 的 
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mapNavigation.put("GPS", true); 
} else if (item.seq >= 201 && item.seq <= 237) { // 分 给 中 国 的 
mapNavigation.put(" 北 斗 ", true); 
} else if (item.seq >= 65 && item.seq <= 89) { // 分 给 俄罗斯 的 
mapNavigation.put(" 格 洛 纳 斯 ", true); 
} else if (item.seq != 193 && item.seq (= 194) { 
mapNavigation.put(" 未 知 ", true); 
} 
} 
// 显示 设备 支持 的 卫星 导航 系统 信息 
showNavigationInfo(); 
case GpsStatus.GPS_EVENT_FIRST_FIX: // 首次 卫星 定位 
case GpsStatus.GPS_EVENT_STARTED: // 卫星 导航 服务 开始 
case GpsStatus.GPS_EVENT_STOPPED: // 卫星 导航 服务 停止 
default: 
break; 
bE 
站 
利用 上 述 代码 中 的 卫星 编号 数据 ， 能 够 获知 当前 设备 集成 了 哪些 卫星 系统 的 导航 芯片 。 如 图 
9-52 所 示 ， 可 见 该 手机 只 配置 了 GPS 的 导航 芯片 ， 又 如 图 9-53 所 示 ， 可 见 该 手机 集成 了 GPS、 
格 洛 纳 斯 、 北 斗 三 大 卫星 系统 的 导航 芯片 。 


(ole 


当前 设备 型 号 为 MI 6 
支持 的 卫星 导航 系统 包括 : 格 洛 纳 斯 、 
北斗 、GPS 





当前 设备 型 号 为 DOOV V3 
支持 的 卫星 导航 系统 包括 : GPS 


图 9-52 A 手机 支持 的 卫星 导航 系统 图 9-53 B 手机 支持 的 卫星 导航 系统 
9.6.3 ”代码 示例 





从 本 章 开 始 ， 代 码 示 例 一 节 将 更 侧重 于 在 真 机 上 进行 相关 测试 ， 对 于 编码 上 的 说 明 仅 限 
于 要 注意 或 容易 遗漏 的 地 方 。 编 码 与 测试 方面 需要 注意 以 下 5 点 : 
(1) 扫 一 扫 用 到 了 zxing 工具 包 ， 要 在 libs 目录 导入 对 应 的 JAR 包 ， 即 zxing3.2.1.jar。 
同时 还 要 在 Java 源码 目录 导入 com.app.zxing 的 开源 框架 。 
(2) 使 用 摄像 头 、 定 位 与 蓝牙 功能 ， 不 要 忘 了 往 AndroidManifest.xml 添加 对 应 的 权限 。 
<!-- 拍照 -> 
<uses-permission android:name="android.permission.CAMERA" 亡 
<uses-feature android:name="android.hardware.camera.autofocus" /> 
<!-- 定位 -> 
<uses-permission android:name="android.permission.ACCESS FINE _ LOCATION" /> 
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<uses-permission android:name="android.permission.ACCESS COARSE LOCATION" /> 
<!-- 蓝牙 -> 

<uses-permission android:name="android.permission.BLUETOOTH ADMIN" /> 
<uses-permission android:name="android.permission.BLUETOOTH" 亡 

<!-- 仅 在 支持 BLE〈 即 蓝牙 4.0) 的 设备 上 运行 -> 

<uses-feature android:name="android.hardware.bluetooth le" android:required="true"/> 


(3) 在 res/raw 目录 下 保存 播放 “ 哗 ” 声 的 音频 文件 ， 在 res/values 目录 下 保存 zxing 框 
架 依 赖 的 ids.xml。 
(4) 需要 自 定义 一 个 博 饼 视图 BettingView， 用 于 展示 摇 货 子 的 动态 效果 。 还 需 自 定义 一 
个 罗盘 视图 CompassView， 用 于 展示 天 空 坐标 和 天 上 的 卫星 分 布 图 。 
(5) 测试 “ 听 一 味 ” 功 能 ， 需 要 找 一 部 支持 北斗 导航 的 中 高 端 手机 ， 测试“ 听 一 听 ” 功 
能 需要 找 一 台 蓝 牙 音 箱 ， 范 例 用 的 是 小 米 方 盒 蓝牙 音箱 。 
下 面 简单 介绍 一 下 本 书 附录 源码 device 模块 中 ， 与 发 现 频道 有 关 的 主要 代码 之 间 关 系 : 
(1) WeFindActivityjava: 发 现 频 道 的 列表 入 口 页 面 。 
(2) FindScanActivity.java: 扫 一 扫 页 面 ， 可 扫描 二 维 码 和 条 形 码 。 
(3) FindShakeActivity.java: 摇 一 摇 页 面 ， 演 示 博 饼 游 戏 。 
(4) FindSmellActivity.java: 啉 一 只 页 面 ， 演 示 卫 星 浑 天 仪 。 
(5) FindListenActivity.java: 听 一 听 页 面 ， 演 示 如 何 通过 蓝牙 音箱 播放 手机 中 的 音乐 。 
实战 项 目 在 模拟 器 上 测试 通过 后 ， 按 照 第 8 章 的 说 明 将 App 安装 到 手机 上 ， 使 用 真 机 进 
行 实际 的 功能 测试 。 
首先 测试 扫 一 扫 功 能 。 如 图 9-54 所 示 为 一 张 清华 大 学 微 信 公 众 号 的 二 维 码 图 片 。 扫 描 结 
果 如 图 9-55 所 示 ， 识 别 的 字符 串 是 一 个 指向 微 信服 务 器 的 HTTP 连接 字符 串 。 





扫 码 结果 为 : http://weixin.qq.com/r/ 
UOMMFPvEqabWrb939xZB 








图 9-54 清华 大 学 微 信 公众 号 的 二 维 码 图 片 图 9-55 扫描 二 维 码 的 识别 结果 


扫 一 扫 其 实 不 只 可 以 扫描 二 维 码 ， 还 可 扫描 条 形 码 。 如 图 9-56 所 示 为 一 张 常 见 的 商品 条 
形 码 图 片 。 扫 描 结果 如 图 9-57 所 示 ， 识 别 的 是 一 串 数字 编号 。 


39382 00039 3 扫 码 结果 为 : 639382000393 






























































图 9-56 某 商品 的 条 形 码 图 片 图 9-57 扫描 条 形 码 的 识别 结果 
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接着 测试 摇 一 摇 功 能 ， 拿 起 手机 使 劲 狗 荡 几 下 ， 看 看 屏幕 界面 是 不 是 动 了 起 来 ? 图 9-58 
与 图 9-59 是 两 张 不 同 的 中 奖 效果 图 。 其 中 ， 图 9-58 表示 摇 中 了 秀才 奖 (一 个 红 四 ) ， 图 9-59 
表示 摇 中 了 状元 奖 (4 个 红 四 ) 。 


摇 一 摇 ， 博 饼 中 大 奖 摇 一 摇 ， 博 饼 中 大 奖 








恭喜 ， 您 的 博 饼 结果 为 : 一 秀 恭喜 ， 您 的 博 饼 结果 为 : 状元 (四 点 红 ) 


图 9-58 摇 一 摇 中 了 一 秀 图 9-59 摇 一 摇 中 了 状元 


因为 角 子 上 的 四 点 与 一 点 为 红色 ,所 以 博 饼 的 中 奖 点 数 围绕 红 四 与 红 一 制定 。 下 面 来 看 
具体 的 中 奖 规则 。 首 先是 以 下 几 个 大 奖 : 


状元 插 金 花 : 4 个 红 四 加 两 个 红 一 

六 杯 红 : 有 6 个 红 四 

遍地 锦 : 有 6 个 红 一 

五 红 : 有 5 个 红 四 

四 点 红 : 有 4 个 红 四 

五 子 登 科 : 有 5 个 相同 的 点 数 (5 个 红 四 除外 ) 

上 面 几 个 都 是 状元 ， 以 状元 插 金 花 为 最 大 。 下 面 则 是 非 状 元 的 其 他 奖项 ; 
对 堂 (榜眼 和 探花 ) : 6 个 骨 子 分 别 是 一 、 二 、 三 、 四 、 五 、 六 
四 进 (进士 ) : 有 4 个 相同 的 点 数 (4 个 红 四 除外 ) 

三 红 ( 贡 士 ) : 有 3 个 红 四 

二 举 (举人 ) : 有 两 个 红 四 

一 秀 (秀才 ) : 只 有 一 个 红 四 


中 国 幅 员 辽 阔 ， 各 地 都 有 自己 的 风俗 ， 般 子 也 不 例外 ， 不 知道 读者 当地 的 货 子 是 什么 玩 
法 ， 要 不 要 把 你 们 的 玩法 写 到 摇 一 摇 里 面 去 呢 ? 

然后 测试 味 一 听 功 能， 这 个 必须 找 个 好 一 点 的 手机 ， 因 为 配置 好 的 手机 才 有 格 洛 纳 斯 与 
北斗 的 导航 蕊 片 。 如 图 9-60 所 示 的 手机 只 支持 GPS 芯片 ， 效 果 图 上 满 屏 都 是 美国 的 卫星 。 如 
图 9-61 所 示 的 手机 同时 内 置 GPS、 格 洛 纳 斯 与 北斗 的 芯片 ， 效 果 图 上 的 卫星 三 国都 有 。 
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device 


当前 定位 类 型 : gps， 定 位 时 间 : 22:52:59 当前 定位 类 型 : gps， 定 位 时 间 : 22:03:16 
经 度 : 119.330952, 纬度 : 26.143372 经 度 : 119.331964， 纬 度 : 26.146343 
高 度 : 480 米 ， 精 度 : 10 米 高 度 : 103 米 ， 精 度 : 8 米 











9-60 只 支持 GPS 的 卫星 分 布 图 图 9-61 支持 3 种 导航 系统 的 卫星 分 布 图 


如 果 手 机 只 支持 GPS， 定 位 响应 就 很 慢 ， 定 位 精度 一 般 在 10 米 左 右 ， 而 且 定 位 高 度 很 不 
准 , 误差 相当 大 。 一 旦 有 北斗 与 格 洛 纳 斯 参与 定位 ， 即 使 在 室内 也 能 很 快 响应 ,精度 一 般 能 提 
升 至 5 米 ， 并 且 高 度数 值 准确 了 许多 ， 特 别 适 合 亚太 地 区 的 定位 需求 。 

再 来 看 如 图 9-61 所 示 的 卫星 分 布 。 在 笔者 头顶 这 片 天 空 半 小 时 内 一 共 找 到 11 颗 GPS 卫 
星 、6 颗 格 洛 纳 斯 卫星 、12 颗 北斗 卫星 ， 原 来 中 国 的 北斗 已 经 赶 上 并 超过 美国 的 GPS 了 。 身 
为 中 国人 的 你 , 有 没有 感到 无 比 感动 与 自豪 ? 快 快 拿 出 手机 试 试 啉 一 啉 功能 , 看 看 你 头 上 的 天 
空 能 找到 几 颗 卫星 。 

最 后 讲 讲 听 一 听 的 实现 ， 通 过 蓝牙 连接 音箱 ， 进 而 把 手机 上 的 音乐 同步 到 音箱 上 播放 ， 
有 具体 的 编码 过 程 主要 有 以 下 三 个 步 又: 


1. 定义 并 设置 A2DP 的 蓝牙 代理 


像 音 乐 播放 这 种 持续 进行 的 动作 ， 都 必须 放 到 后 台 服 务 Service 中 进行 ， 以 免 影响 用 户 在 
界面 上 的 操作 。 故 而 A2DP 采取 类 似 服务 的 绑 定 / 解 绑 方式 工作 ， 也 需 开发 者 定义 一 个 蓝牙 代 
理 的 服务 监听 器 ， 该 监听 器 通过 onServiceConnected 方法 表达 已 连接 状态 ， 通 过 
onServiceDisconnected 方法 表达 已 断 开 状态 。 下 面 是 服务 监听 器 的 定义 代码 示例 : 

private BluetoothA2dp bluetoothA2dp:; / 声明 一 个 蓝牙 音频 传输 对 象 

// 定义 一 个 A2DP 的 服务 监听 器 ， 类 似 于 Service 的 绑 定 方式 启 停 ， 

// 也 有 onServiceConnected 和 onServiceDisconnected 两 个 接口 方法 

private BluetoothProfile.ServiceListener serviceListener = new BluetoothProfile.ServiceListener() { 


/ 在 服务 断 开 连 接 时 触发 
public void onServiceDisconnected(int profile) { 
if (profile 一 BluetoothProfile.A2DP) { 
/1A2DP 已 连接 ， 则 释放 A2DP 的 蓝牙 代理 
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bluetoothA2dp = null; 
} 


/ 在 服务 建立 连接 时 触发 
public void onServiceConnected(int profile, final BluetoothProfile proxy) { 
if (profile 一 BluetoothProfile. A2DP) { 
/1A2DP 已 连接 ， 则 设置 A2DP 的 蓝牙 代理 
bluetoothA2dp = (BluetoothA2dp) proxy; 


$s 
接着 还 要 给 蓝牙 对 象 设置 这 个 服务 监听 器 ， 这 样 手机 蓝牙 才能 及 时 获取 A2DP 代理 ， 设 
置 代码 如 下 所 示 : 
/ 获取 A2DP 的 蓝牙 代理 
mBluetooth.getProfileProxy(this, serviceListener, BluetoothProfile.A2DP); 


2. 发 现 蓝牙 音箱 ， 并 进行 配对 和 连接 


搜索 并 发 现 周 围 的 蓝牙 设备 ， 该 功能 对 应 的 代码 已 经 在 前 面 的 “9.5.3 蓝牙 BlueTooth” 
做 了 详细 介绍 ， 此 处 不 再 歼 述 。 找 到 蓝牙 音箱 之 后 ， 还 要 手机 主动 与 它 连 接 。 按 照 “9.5.3 蓝 
牙 BlueTooth” 小 节 的 做 法 ， 接 下 来 要 通过 BluetoothDevice 类 进行 配对 和 取消 配对 操作 ， 但 那 
是 针对 普通 蓝牙 设备 而 言 。 对 于 遵循 A2DP 标准 的 蓝牙 耳机 和 蓝牙 音箱 来 说 ， 得 使 用 
BluetoothA2dp 类 完成 播音 设备 的 连接 与 断 开 连接 操作 。 下 面 是 BluetoothA2dp 类 的 常用 方法 
说 明 。 
e setPriority: 设置 A2DP 设备 的 优先 级 ， 需 要 设置 成 100， 表 示 优 先 用 蓝牙 设备 播放 音乐 ， 
而 不 是 用 手机 自 带 的 扬声器 播放 。 该 方法 为 隐藏 方法 ， 需 要 通过 反射 调用 。 
econnect: 连接 A2DP 设备 ， 连 接 成 功 之 后 ， 音 乐 即 可 在 该 蓝牙 设备 上 播放 。 该 方法 为 隐 
藏 方法 ， 需 要 通过 反射 调用 。 
edisconnect: 断 开 A2DP 设备 ， 此 时 倘若 音乐 仍 在 演奏 ， 则 由 手机 麦克 风 播 放 。 该 方法 为 
隐藏 方法 ， 需 要 通过 反射 调用 。 


3. 定义 A2DP 的 广播 接收 器 ， 并 注册 相关 广播 事件 


BluetoothA2dp 类 的 connect 方法 跟 BluetoothDevice 类 的 createBond 方法 一 样 都 会 弹出 配 
对 确认 框 ， 只 有 用 户 点 击 对 话 框 上 的 “配对 ”按钮 ， 才 算 与 蓝牙 音箱 连接 成 功 。 由 于 需要 等 待 
用 户 确认 ， 因 此 确认 结果 也 采取 广播 方式 返回 。 普 通 设备 的 配对 结果 ， 对 应 的 广播 事件 是 
BluetoothDevice.ACTION_BOND _STATE_CHANGED: 蓝牙 音箱 的 连接 结果 ， 则 对 应 广播 事 
件 BluetoothA2dp.ACTION_CONNECTION_STATE_CHANGED。 除 了 连接 状态 变更 广播 ( 含 
已 连接 和 已 断 开 ) ， 另 有 A2DP 播放 状态 的 变更 广播 〈 含 正在 播放 和 停止 播放 ) ， 可 在 接收 
到 具体 广播 时 进行 相应 的 业务 处 理 。 
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下 面 是 A2DP 广播 接收 器 的 定义 与 注册 代码 例子 : 


protected void onStartO { 
super.onStart(); 
// 创建 一 个 意图 过 滤器 
IntentFilter a2dpFilter = new IntentFilter(); 
// 指定 A2DP 的 连接 状态 变更 广播 
a2dpFilter.addAction(BluetoothA2dp.ACTION CONNECTION STATE CHANGED); 
/ 指定 A2DP 的 播放 状态 变更 广播 
a2dpFilter.addAction(BluetoothA2dp.ACTION PLAYING STATE CHANGED); 
/ 注册 A2DP 连接 管理 的 广播 接收 器 
registerReceiver(a2dpReceiver, a2dpFilter); 


// 定义 一 个 A2DP 连接 的 广播 接收 器 
private BroadcastReceiver a2dpReceiver = new BroadcastReceiver() { 
(QOverride 
public void onReceive(Context context, Intent intent) { 
switch (intent.getAction()) { 
/ 侦 听 到 A2DP 的 连接 状态 变更 广播 
case BluetoothA2dp.ACTION_ CONNECTION STATE CHANGED: 
BluetoothDevice device = mBluetooth.getRemoteDevice(mAddress); 
int connectState = intent.getIntExtra(BluetoothA2dp.EXTRA_STATE, 
BluetoothA2dp.STATE_DISCONNECTED); 
if (connectState 一 BluetoothA2dp.STATE_ CONNECTED) { 
// 收 到 连接 上 的 广播 ， 则 更 新 设备 状态 为 已 连接 
refreshDevice(device, BlueListAdapter.CONNECTED); 
ap_music.initFromRaw(mContext, R.raw.mountain_and_water); 
Toast.makeText(mContext, "已 连 上 蓝牙 音箱 。 快 来 播放 音乐 试 试 "， 
Toast. LENGTH_SHORT).show(); 
} else if (connectState 一 BluetoothA2dp.STATE_DISCONNECTED) { 
/ 收 到 断 开 连 接 的 广播 ， 则 更 新 设备 状态 为 已 断 开 
refreshDevice(device, BluetoothDevice. BOND_NONE); 
Toast.makeText(mContext, "已 断 开 蓝牙 音箱 "， 
Toast. LENGTH_SHORT).show(): 
} 
break; 
// 侦 听 到 A2DP 的 播放 状态 变更 广播 
case BluetoothA2dp.ACTION_PLAYING STATE CHANGED: 
int playState = intent.getIntExtra(BluetoothA2dp.EXTRA STATE, 
BluetoothA2dp.STATE NOT_PLAYING); 
if (playState == BluetoothA2dp.STATE PLAYING) { 
Toast.makeText(mContext, "蓝牙 音箱 正在 播放 ", 
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Toast LENGTH_SHORT).show(): 
} else if (playState 一 BluetoothA2dp.STATE NOT PLAYING){ 
Toast.makeText(mContext, "蓝牙 音箱 停止 播放 ", 
ToastLENGTH SHORT).show(0; 


break:; 


上 


实战 项 目的 “ 听 一 听 〔〈 蓝 牙 播音 乐 ) ”采用 小 米 的 方 盒 蓝牙 音箱 演示 ， 手 机 打开 蓝牙 功 
能 ， 搜 寻 到 的 蓝牙 设备 列表 如 图 9-62 所 示 ， 其 中 名 称 为 “XMFHZ02” 的 就 是 小 米 方 盒 音 箱 。 














[we 


请 先 连 接 音箱 ， 再 点 击 播放 《高 山 流水 》 


开始 播放 
请 先 开启 蓝牙 音箱 电源 ， 然 后 在 下 面 连接 音箱 


蓝牙 开 正在 搜索 蓝牙 设备 


点 击 蓝牙 音箱 开始 连接 ， 再 点 击 取消 连接 
名 称 地 址 状态 


XMFHZ02 F4:4E:FD:74:61:4E ”未 绑 定 





9-62 ”搜索 蓝牙 设备 发 现 蓝牙 音箱 


点 击 设备 列表 中 的 小 米 音 箱 ， 则 命令 代码 调用 BluetoothA2dp 对 象 的 connect 方法 (通过 
反射 调用 ) ， 些 时 界面 弹出 配对 确认 对 话 框 如 图 9-63 所 示 。 然 后 用 户 点 击 “ 配 对 ”按钮 ， 系 
统 通过 广播 返回 已 连 上 的 结果 ， 于 是 更 新 设备 列表 的 音箱 状态 为 “已 连接 ”， 更 新 状态 后 的 列 
表 界 面 如 图 9-64 所 示 。 























蓝牙 配对 请 求 
请 先 连接 音箱 ， 再 点 击 播放 《高 山 流水 》 
XMFHZ02 开始 播放 
AR 请 先 开启 蓝牙 音箱 电源 ， 然 后 在 下 面 连接 间 箱 
配 所 在 建立 连接 后 访问 蓝牙 开 正在 搜索 蓝牙 设备 
点 击 蓝牙 音箱 开始 连接 ， 再 点 击 取消 连接 
名 称 地 址 状态 








XMFHZ02 F4:4E:FD:74:61:4E 已 连接 





图 9-63 ”蓝牙 音箱 的 配对 确认 框 图 9-64 已 经 连 上 蓝牙 音箱 
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演示 界面 在 下 方 集 成 了 古筝 曲 《 高 山 流水 》 的 播放 控制 条 ， 既 然 连 上 了 蓝牙 音箱 ， 那 就 
赶快 点 击 “ 播 放 ” 按 钮 ， 于 是 美妙 的 古韵 余音 便 缓 缓 地 从 音箱 中 流 消 出 来 了 。 因 为 音乐 播放 的 
旋律 无 法 直接 通过 图 文 表达 ,所 以 下 面 聊 且 奉 上 古 第 曲 的 播放 进度 界面 如 图 9-65 和 9-66 所 示 ， 
其 中 图 9-65 为 音乐 开始 播放 不 久 的 进度 ， 图 9-66 为 音乐 暂停 播放 时 的 进度 。 




















请 先 连接 音箱 ， 再 点 击 播放 《高 山 流水 》 


请 先 连接 音箱 ， 再 点 击 播放 《高 山 流水 》 


暂停 播放 开始 播放 
请 先 开启 蓝牙 音箱 电源 ， 然 后 在 下 面 连接 音箱 请 先 开启 蓝牙 音箱 电源 ， 然 后 在 下 面 连接 音箱 
蓝牙 开 正在 搜索 蓝牙 设备 蓝牙 开 正在 搜索 蓝牙 设备 
点 击 蓝牙 音箱 开始 连接 ， 再 点 击 取消 连接 点 击 蓝牙 音箱 开始 连接 ， 再 点 击 取消 连接 
名 称 地 址 状态 名 称 地 址 状态 











XMFHZ02 F4:4E:FD:74:61:4E “已 绑 定 XMFHZ02 F4:4E:FD:74:61:4E “已 绑 定 


图 9-65 音乐 开始 播放 不 久 的 进度 图 9-66 音乐 暂停 播放 时 的 进度 
9.7 小 结 


本 章 主要 阐述 了 手机 上 硬件 设备 的 使 用 介绍 与 操作 说 明 ， 包 括 摄像 头 的 用 法 〈 表 面 视 图 、 
相机 、 纹理 视图 、 二 代 相 机 )、 麦 克 风 的 用 法 〈 拖 动 条 、 音 量 控制 、 录 音 与 播音 、 录 像 与 放映 ) 、 
传感器 的 用 法 《传感器 的 种 类 、 加 速度 传感器 、 指 南 针 、 计 步 器 、 感 光 器 、 陀 螺 仪 ) 、 手 机 定 
位 的 用 法 《定位 的 原理 、 开 启 定位 功能 、 获 取 定位 信息 ) 、 短 距离 通信 技术 的 应 用 (NFC 近 
场 通信 、 红 外 遥控 、 蓝 牙 配对 ) 。 最 后 设计 了 一 个 实战 项 目 “ 仿 微 信 的 发 现 功能 ”， 在 该 项 目 
的 App 编码 中 ， 实 现 了 扫 一 扫 (扫描 二 维 码 ) 、 摇 一 摇 〈 博 饼 抽 大 奖 ) 、 听 一 味 〈 卫 星 浑 天 
仪 ) 、 听 一 听 〈 蓝 牙 播 音乐 ) 4 种 功能 。 另 外 ， 介 绍 了 卫星 导航 系统 的 相关 知识 。 

通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 6 种 开发 技能 : 


(1) 学 会 操纵 相机 实现 拍照 功能 〈 含 单 拍 和 连 拍 ) 。 

(2) 学 会 操纵 相机 与 麦克 风 实 现 媒体 录制 功能 〈 含 录音 和 录像 ) 。 

(3) 学 会 音频 和 视频 的 播放 功能 。 

(4) 学 会 常见 传感器 的 用 法 〈 含 加 速度 传感器 、 磁 场 传感器 、 计 步 器 、 陀 螺 仪 等 ) 。 
(5) 学 会 如 何 获取 位 置信 息 〈 含 卫星 定位 和 网 络 定位 ) 。 

(6) 学 会 短 距离 通信 技术 的 运用 ( 含 NFC、 红 外 、 蓝 牙 等 ) 。 





本 章 介绍 App 开发 常用 的 一 些 网 络 通信 技术 ， 主 要 包括 如 何 使 用 多 线程 完成 异步 操作 、 
如 何 进行 HTTP 接口 调用 与 图 片 获取 、 如 何 实现 文件 上 传 和 下 载 操作 、 如 何 运 用 Socket 通信 
技术 等 ,最 后 结合 本 章 所 学 的 知识 分 别 演示 了 两 个 实战 项 目 “ 仿 应 用 宝 的 应 用 更 新 功能 ”和 “ 仿 
手机 QQ 的 聊天 功能 ”的 设计 与 实现 。 


10.1 多 线程 


本 节 介 绍 多 线程 技术 在 App 开发 中 的 具体 运用 ,首先 说 明 如 何 利用 Message 配合 Handler 
完成 主线 程 与 分 线程 之 间 的 简单 通信 ; 然后 阐述 进度 对 话 框 的 用 法 , 以 及 如 何 自 定义 实现 文本 
进度 条 与 文本 进度 圈 ; 接着 讲述 异步 任务 AsyncTask 的 具体 用 法 和 注意 事项 ; 最 后 分 析 异 步 服 
务 IntentService 的 实现 原理 和 开发 步骤 。 


10.1.1 消息 传递 Message 


为 了 使 App 运行 得 更 流畅 ， 多 线程 技术 被 广泛 应 用 于 App 开发 。 由 于 Android 系统 存在 
限制 ， 只 有 主线 程 才能 直接 操作 界面 ， 因 此 分 线程 想 修改 界面 就 得 另 想 办 法 。 第 9 章 在 介绍 摄 
像 头 拍照 时 提 到 为 了 让 分 线程 能 够 刷新 界面 ，Android 专门 设计 了 表面 视图 SurfaceView 给 分 
线程 操作 ， 后 来 又 增加 了 纹理 视图 TextureView， 也 是 给 分 线程 使 用 。 

多 线程 技术 并 非 单单 用 于 拍照 预览 ， 还 用 于 网 络 通信 、 后 台 服 务 等 耗 时 场合 ， 并 且 这 些 
场合 往往 希望 操纵 现 有 的 界面 , 而 不 是 操纵 表面 视图 。 这 要 求 有 一 种 用 于 线程 之 间 相互 通信 的 
机 制 。 大 家 都 知道 ， 主 线程 向 分 线程 传递 消息 时 可 以 直接 在 分 线程 的 构造 函数 中 传递 参数 ， 然 
而 分 线程 向 主线 程 传递 消息 并 无 捷径 ， 为 此 Android 设计 了 一 个 Message 消息 工具 , 通过 结合 
Handler 与 Message 可 简单 有 效 地 实现 线程 之 间 的 通信 。 
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主线 程 与 分 线程 之 间 传 递 消 息 的 步骤 主要 有 4 步 ， 说 明 如 下 : 


在 主线 程 中 构造 一 个 Handler 对 象 ， 并 启动 分 线程 


处 理 器 Handler 是 大 家 的 老 朋 友 了 ， 从 第 2 章 开 始 ， 凡 是 需要 进行 延迟 处 理 的 场合 ， 基 本 
都 用 到 了 Handler。 特 别 是 在 第 6 章 ， 在 介绍 简单 动画 的 实现 时 还 专门 对 Handler+rRunnable 组 
合 做 了 详细 说 明 。Thread 类 是 Runnable 接口 的 一 个 具体 实现 ，Handler 调用 Runnable 对 象 的 
各 种 post 方法 也 适用 于 Thread 对 象 。 启 动 分 线程 有 两 种 方式 ， 既 可 通过 Handler 对 象 的 post 
方法 启动 Thread， 也 可 直接 调用 Thread 对 象 的 start 方法 。 


2. 


在 分 线程 中 构造 一 个 Message 对 象 的 消息 包 


Message 是 多 线程 通信 中 存放 消息 的 包 库 , 作用 类 似 于 Intent 机 制 的 Bundle 工具 。 实例 可 
通过 自身 的 obtain 方法 获得 ， 也 可 通过 Handler 对 象 的 obtainMessage 方法 获得 。 
下 面 来 看 Message 类 的 主要 参数 说 明 。 


3. 


what: 整 型 的 消息 标识 ， 用 于 标识 本 次 消息 的 唯一 编号 。 

argl: 整 型 数 ， 可 存放 消息 的 处 理 结果 。 

arg2: 整 型 数 ， 可 存放 消息 的 处 理 代码 。 

obj: Object 类 型 ， 可 存放 返回 消息 的 数据 结构 。 

replyTo: Messenger 类 型 ， 回 应 信使 ， 在 跨 进程 通信 中 使 用 ， 多 线程 通信 用 不 着 。 


在 分 线程 中 通过 Handler 对 象 将 Message 消息 发 出 去 


可 
可 





处 理 器 Handler 的 消息 发 送 操作 主要 是 各 类 send 方法 。 下 面 介绍 相关 方法 说 明 。 


4. 


obtainMessage: 获取 当前 消息 的 对 象 。 

sendMessage: 立即 发 送 消息 。 

sendMessageDelayed: 延迟 一 段 时 间 后 发 送 消息 .。 
sendMessageAtTime: 在 指定 时 间 点 发 送 消息 。 
sendEmptyMessage: 立即 发 送 空 消息 。 
sendEmptyMessageDelayed: 延迟 一 段 时 间 后 发 送 空 消息 。 
sendEmptyMessageAtTime: 在 指定 时 间 点 发 送 空 消息 。 
removeMessages: 从 消息 队列 中 根据 指定 标识 移 除 对 应 消息 。 
hasMessages: 判断 消息 队列 中 是 否 存在 指定 标识 的 消息 。 


主线 程 中 的 Handler 对 象 处 理 接收 到 的 消息 


主线 程 处 理 分 线程 发 出 的 消息 需要 实现 Handler 对 象 的 handleMessage 方法 ,根据 Message 
消息 的 具体 内 容 分 别 进行 相应 处 理 。 注意, 因为 handleMessage 方法 处 于 主线 程 (UI 线程 ) 中 ， 
所 以 该 方法 内 部 可 以 直接 操作 界面 元 素 。 

下 面 是 利用 多 线程 实现 新 闻 滚 动 的 完整 代码 ， 结 合 使 用 了 Handler 与 Message。 


public class MessageActivity extends AppCompatActivity implements OnClickListener { 


private TextView tv_message; / 声明 一 个 文本 视图 对 象 
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private boolean isPlaying = 包 lse; // 是 否 正在 播放 新 闻 
private int BEGIN = 0,SCROLL = 1, END = 2; // 0 为 开始 ，1 为 滚动 ，2 为 结束 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_message); 
/ 从 布局 文件 中 获取 名 叫 tv_control 的 文本 视图 
tv_message= findViewById(R.id.tv_message); 
/ 设置 tv_message 内 部 文字 的 对 齐 方式 为 靠 左 且 靠 下 
tv_message.setGravity(GravityLEFT | Gravity. BOTTOM); 
tv_message.setLines(8); / 设置 ty_message 高 度 为 8 行文 字 那 么 高 
tv_message.setMaxLines(8); // 设置 tv_ message 最 多 显示 8 行文 字 
/ 设置 tv_message 内 部 文本 的 移动 方式 为 滚动 形式 
tv_message.setMovementMethod(new ScrollingMovementMethod0O); 
findViewById(R.id.btn_start message).setOnClickListener(this); 
findViewById(R.id.btn_stop_message).setOnClickListener(this); 

1 


public void onClick(View v) { 
让 (v.getId() 一 R.id.btn_start_message) { // 点 击 了 开始 播放 新 闻 的 按钮 
if (lisPlaying) { 
isPlaying = true; 
new PlayThread().start(); / 创建 并 启动 新 闻 播放 线程 
E 
} else if (v.getId() 一 R.id.btn_stop_message) { // 点 击 了 结束 播放 新 闻 的 按钮 
isPlaying = false; 
} 
人 


private String[] mNewsArray = { "北斗 三 号 卫星 发 射 成 功 ， 定 位 精度 媲美 GPS"， 


"美国 赌 城 拉 斯 维 加 斯 发 生 重大 枪击 事件 ", "日 本 在 越南 承建 的 跨 海 大 桥 未 建 完 已 下 沉 "， 
"南水北调 功 在 当代 ， 数 亿 人 喝 上 长 江水 ", "马克 龙 呼吁 重建 可 与 中 国 匹 敌 的 强大 欧洲 " }; 


/ 定义 一 个 新 闻 播放 线程 
private class PlayThread extends Thread { 
(OOverride 
public void run() { 
// 向 处 理 器 发 送 播放 开始 的 空 消息 
mHandler.sendEmptyMessage(BEGIN); 
while (isPlaying) { 
ty { 
sleep(2000); 
} catch (InterruptedException e) { 
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€.printStack Trace(); 
中 
Message message = Message.obtain0; / 获得 一 个 默认 的 消息 对 象 
message.what = SCROLL; // 消息 类 型 
message.obj = mNewsArray[(int) (Math.random() * 30 % 5)]; / 消息 描述 
mHandlersendMessage(message); / 向 处 理 器 发 送 消息 
} 
isPlaying = true; 
ty{ 
sleep(2000); 
} catch (InterruptedException e) { 
€.printStackTrace(); 
} 
mHandlersendEmptyMessage(END); / 向 处 理 器 发 送 播放 结束 的 空 消息 
isPlaying = false; 


) 


// 创建 一 个 处 理 器 对 象 
private HandlermHandler= new Handler() { 
/ 在 收 到 消息 时 触发 
public void handleMessage(Message msg) { 
String desc = tv_message.getText().toString(); 
if(msg.what 一 BEGIN) { / 开始 播放 
desc = String.format("%sn%s %s", desc, DateUtil.getNowTime(), "下 面 播放 新 闻 "); 
} else if (msg.what 一 SCROLL) { // 滚动 播放 
desc = String.format("%s\n%s %s", desc, DateUtil.getNowTime(), msg.obj); 
} else if (msg.what 一 END) { // 结束 播放 
desc = String.format("%s\n%s %s", desc, DateUtil.getNowTime(), "新 闻 播 放 结束 "); 
} 


tv_message.setText(desc); 


bs 
上 
新 闻 滚 动 的 效果 如 图 10-1 与 图 10-2 所 示 。 其 中 ， 图 10-1 所 示 为 正在 播放 新 闻 的 界面 ， 
分 线程 每 隔 两 秒 添加 一 条 新 闻 ; 图 10-2 所 示 为 新 闻 播 放 结束 时 的 界面 ， 主 线程 收 到 分 线程 的 
END 消息 ， 在 界面 上 提示 用 户 “新 闻 播放 结束 ”。 
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22:59:22 开始 播放 新 闻 
22:59:24 美国 赌 城 拉 斯 维 加 斯 发 生 重大 枪击 事件 





强 尘 36 上 


开始 播放 新 闻 停止 播放 新 闻 


开始 播放 新 闻 


23: 0 14 a 


北斗 三 号 卫星 发 射 成 功 ， 定 位 精度 媲美 GPS 
马克 龙 呼吁 重建 可 与 中 国 匹 敌 的 强大 欧洲 


在 当代 ， 亿 人 | 喝 上 长 江水 
星 发 射 成 功 ， 全 位 毅 度 肖 革 cps 





峡 0 28 新 闻 播放 结束 








图 10-1 正在 播放 新 闻 的 界面 图 10-2 停止 播放 新 闻 的 界面 





10.1.2 ”进度 对 话 框 ProgressDialog 


有 时 ， 分 线程 在 处 理事 务 期 间 不 允许 用 户 继续 操作 界面 控件 ， 但 是 还 想 提示 用 户 “ 页 面 
正在 加 载 ， 请 耐心 等 待 ” 之 类 信息 ， 必 要 时 还 会 告知 用 户 当前 的 处 理 进 度 ， 这 种 情况 就 会 用 到 
进度 对 话 框 ProgressDialog。 分 线程 正在 处 理 时 ， 界 面 弹出 进度 对 话 框 ， 分 线程 处 理 结束 时 ， 
自动 关闭 进度 对 话 框 。 这 样 既 确 保 分 线程 不 受 干 扰 ， 又 缓解 了 用 户 的 焦急 等 待 。 

进度 对 话 框 继承 自 提醒 对 话 框 AlertDialog， 内 部 集成 了 进度 条 ProgressBar， 既 拥有 
AlertDialog 的 所 有 方法 ， 又 实现 了 ProgressBar 的 公开 API。 下 面 是 进度 对 话 框 的 常用 方法 。 


setTitle: 设置 对 话 框 的 标题 文本 。 
setMessage: 设置 对 话 框 的 消息 内 容 。 
setIcon: 设置 对 话 框 的 图 标 。 
setProgress: 设置 当前 进度 的 数值 。 
setSecondaryProgress: 设置 当前 第 二 进度 的 数值 。 
setMax: 设置 进度 条 的 最 大 进度 数值 。 
setProgressStyle: 设置 进度 条 的 样式 。 取 值 ProgressDialog.STYLE_SPINNER 表示 转圈 风 
格 (默认 值 ) ， 取 值 ProgressDialog.STYLE_HORIZONTAL 表示 长 条 风格 。 
show: 显示 对 话 框 。 需 要 在 各 属性 设置 完成 后 调用 show 方法 。 
isShowing: 判断 对 话 框 是 否 正在 显示 。 
dismiss: 关闭 对 话 框 。 
静态 的 show 方法 : 简化 的 调用 方法 ， 一 旬 代 码 就 搞定 进度 对 话 框 的 设置 与 显示 。 可 同 
时 指定 标题 文字 和 消息 内 容 ， 进 度 条 样式 为 默认 的 转圈 ， 示 例 代码 如 下 : 
/ 弹出 带 有 提示 文字 的 圆圈 进度 对 话 框 
mDialog = ProgressDialog.show(this, "请 稍 候 ", "正在 努力 加 载 页 面 "); 


下 面 是 使 用 进度 对 话 框 的 代码 片段 : 


private ProgressDialog mDialog; // 声明 一 个 进度 对 话 框 对 象 

private String[] descArray = 如 圆圈 进度 ", "水 平 进度 条 "}; 

private int[] styleArray = {ProgressDialog.STYLE_SPINNER. 
ProgressDialog .STYLE_HORIZONTAL}; 
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class StyleSelectedListener implements OnltemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
让 (mDialog 一 null | ImDialog.isShowingO) { // 进度 框 未 弹出 

mStyleDesc = descArray[arg2]; 

int style = styleArray[arg2]; 

f(style 一 ProgressDialog.STYLE_SPINNER) { / 圆圈 进度 框 
/ 弹出 带 有 提示 文字 的 圆圈 进度 对 话 框 
mDialog = ProgressDialog.show(ProgressDialogActivity.this, 

"请 稍 候 ", "正在 努力 加 载 页 面 "); 

// 延迟 1500 毫秒 后 启动 关闭 对 话 框 的 任务 
mHandler.postDelayed(mCloseDialog, 1500); 

} else { // 水 平 进度 框 
/ 创建 一 个 进度 对 话 框 
mDialog = new ProgressDialog(ProgressDialogActivity.this); 
mDialog.setTitle(" 请 稍 候 ")，// 设置 进度 对 话 框 的 标题 文本 
mDialog.setMessage(" 正 在 努力 加 载 页 面 ")，// 设置 进度 对 话 框 的 内 容 文本 
mDialog.setMax(100); / 设置 进度 对 话 框 的 最 大 进度 
mDialog.setProgressStyle(style); / 设置 进度 对 话 框 的 样式 
mDialog.show0; / 显示 进度 对 话 框 
new RefreshThread0).start(); // 启动 进度 刷新 线程 


} 


public void onNothingSelected(AdapterView<?> arg0) {} 
bi 


// 定义 一 个 关闭 对 话 框 的 任务 
private Runnable mCloseDialog = new Runnable() { 
(@Override 
public void run() { 
让 (mDialogiisShowing()) { // 对 话 框 仍 在 显示 
mDialog.dismiss(); / 关闭 对 话 框 
tv_result.setText(DateUtil.getNowTime() + " "+ mStyleDesc + "加 载 完成 "); 


上 


/ 定义 一 个 进度 刷新 线程 

private class RefreshThread extends Thread { 
@Override 
public void run0) { 
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for(inti=0;i<10; i++H) { 
Message message = Message.obtain(); / 获得 一 个 默认 的 消息 对 象 
message.what = 0; // 消息 类 型 
message.arg1 =i* 10; // 消息 数值 
mHandler.sendMessage(message); / 往 处 理 器 发 送 消息 对 象 
try{ 
sleep(500); 
} catch (InterruptedException e) { 
€.printStack Trace(); 
! 
上 
mHandlersendEmptyMessage(1); / 往 处 理 器 发 送 类 型 为 1 的 空 消息 


) 


// 创建 一 个 处 理 器 对 象 
private Handler mHandler = new Handler() { 
/ 在 收 到 消息 时 触发 
public void handleMessage(Message msg) { 
让 (msg.what 一 0) { / 该 类 型 表示 刷新 进度 
mDialog.setProgress(tmsg.argl); / 设置 进度 对 话 框 上 的 当前 进度 
} else if(msg.what 一 1){ // 该 类 型 表示 关闭 对 话 框 
post(mCloseDialog); / 立即 启动 关闭 对 话 框 的 任务 
b 


$B 


进度 对 话 框 的 展示 效果 如 图 10-3 与 图 10-4 所 示 。 其 中 ， 如 图 10-3 所 示 为 转圈 进度 样式 ， 
对 话 框 在 1.5 秒 后 自动 关闭 ， 如 图 10-4 所 示 为 长 条 进度 样式 ， 每 隔 0.5 秒 进度 数值 增加 10， 
在 5 秒 后 关闭 对 话 框 。 


出 人 
十 相 恢 


请 稍 候 





正在 努力 加 载 页 面 
正在 努力 加 载 页 面 


30/100 





图 10-3 ”转圈 样式 的 进度 对 话 框 图 10-4 长 条 样式 的 进度 对 话 框 
当然 ，Android 默认 的 进度 条 并 不 好 看 ， 而 且 没有 自 带 的 进度 文字 提示 ， 实 际 开 发 中 往往 
要 重新 定制 , 使 之 符合 用 户 的 视觉 习惯 。 主要 的 改造 方向 有 两 种 : 在 长 条 进度 中 增加 文字 说 明 
和 在 圆圈 进度 中 增加 文字 说 明 。 
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1. 在 长 条 样式 中 增加 文字 说 明 


修改 长 条 样式 的 展示 效果 可 通过 定义 层次 图 形 并 给 progressDrawable 属性 赋值 层次 图 形 
实现 ， 具 体 方法 参见 第 6 章 的 “6.4.2 进度 条 ProcessBar”。 如 果 想 在 进度 条 中 央 显 示 进 度 文 
字 ， 就 得 基于 ProgressBar 自 定 义 一 个 进度 条 工具 ， 主 要 思路 是 在 onDraw 方法 中 调用 canvas 
的 drawText 方法 往 进度 条 上 添加 指定 文本 。 

具体 的 代码 实现 不 难 ， 读 者 可 尝试 自行 编码 ， 也 可 参考 本 书 附 带 源码 network 模块 的 
TextProgressBar.java。 文 字 进 度 条 的 显示 效果 如 图 10-5 与 图 10-6 所 示 。 其 中 ， 图 10-5 是 进度 
为 40% 时 的 界面 ， 图 10-6 是 进度 为 80% 时 的 界面 。 


network network 


请 选择 进度 值 40 ”| | 请 选择 进度 值 80 


当前 处 理 进 度 为 40% 当前 处 理 进度 为 80% 





图 10-5 进度 为 40% 的 进度 条 图 10-6 进度 为 80% 的 进度 条 
2. 在 圆圈 进度 中 增加 文字 说 明 


与 长 条 进度 相 比 ，App 使 用 圆圈 进度 更 加 常见 ， 可 是 ProgressBar 的 圆圈 样式 无 法 设 定 具 
体 的 进度 值 ， 若 要 采用 圆圈 进度 ， 则 必须 完全 据 弃 ProgressBar， 从 头 实现 自 定 义 的 圆圈 进度 
工具 。 如 果 读 者 已 仔细 阅读 本 书 前 面 的 章节 ,相信 你 已 经 有 了 大 概 思 路 ,就 是 利用 第 6 章 的 自 
定义 圆 弧 动画 (参见 “6.2.3 圆 弧 进度 动画 ”)》 先 画 个 背景 圆 环 ， 再 根据 进度 比例 画 个 前 景 圆 
弧 ， 最 后 在 圆心 处 添加 进度 文本 。 

具体 的 实现 代码 不 再 奖 述 ,读者 可 参照 以 上 思路 进行 编码 ,也 可 参考 本 书 附 带 源码 network 
模块 的 TextProgressCircle.java， 自 己 动手 实践 。 文 字 进 度 圈 的 显示 效果 如 图 10-7 与 图 10-8 所 
示 。 其 中 ， 图 10-7 是 进度 为 30% 时 的 界面 ， 图 10-8 是 进度 为 70% 时 的 界面 。 








请 选择 进度 值 30 > 请 选择 进度 值 70 
30% ) 70% 
图 10-7 进度 为 30% 的 进度 圈 图 10-8 ”进度 为 70% 的 进度 圈 


10.1.3 “异步 任务 AsyncTask 


Thread+Handler 方式 虽然 能 够 实现 多 线程 的 通信 和 处理, 但 是 写 代码 颇 为 麻烦 ,不 但 调用 流 
程 很 烦琐 ， 而 且 处 理 代 码 跟 活 动 页 面 代码 混在 一 起 ， 非 常 不 宜 维 护 。 基 于 以 上 问题 ，Android 
提供 了 AsyncTask 这 个 轻 量 级 的 异步 任务 工具 ， 内 部 已 经 封装 好 Thread+Handler 的 线程 通信 
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机 制 ， 开 发 者 只 需 按部就班 地 编写 业务 代码 ， 无 须 关 心 线程 通信 的 复杂 流程 。 AsyncTask 通常 
用 于 网 络 访问 操作 ， 包 括 HTTP 接口 调用 、 文 件 下 载 与 上 传 等 。 

AsyncTask 是 一 个 模板 类 (AsyncTask<Params, Progress, Result>) ， 从 它 派生 而 来 的 新 类 
需要 指定 模板 的 参数 类 型 。 下 面 来 看 模板 参数 说 明 。 


Params: 任务 启动 时 的 输入 参数 ， 比 如 HTTP 访问 的 URL 地 址 、 请 求 报 文 等 。 可 设置 为 
String 类 型 或 自 定义 的 数据 结构 。 


e@ Progress: 任务 执行 过 程 中 的 进度 。 一 般 设置 为 Integer 类 型 ， 表 示 当 前 处 理 进 度 。 
e@ Result: 任务 执行 完 的 结果 参数 ， 比 如 HTTP 调用 的 执行 结果 、 返 回报 文 等 。 可 设置 为 


String 类 型 或 自 定义 的 数据 结构 。 


开发 者 自 定义 的 任务 类 需要 实现 以 下 方法 。 


@ ”onPreExecute: 准备 执行 任务 时 触发 。 该 方法 在 doInBackground 方法 执行 之 前 调用 。 
e@ doInBackground: 在 后 台 执 行 的 业务 处 理 。 网 络 请 求 等 异步 处 理 操 作 都 放 在 该 方法 中 ， 


输入 参数 对 应 execute 方法 的 输入 参数 ， 输 出 参数 对 应 onPostExecute 方法 的 输入 参数 。 
注意 ， 该 方法 运行 于 分 线程 ， 不 能 操作 界面 ， 其 他 方法 都 能 操作 界面 。 
onProgressUpdate: 在 doInBackground 方法 中 调用 publishProgress 方法 时 触发 。 该 方法 通 
常用 于 在 处 理 过 程 中 刷新 进度 条 。 

onPostExecute: 任务 执行 完成 时 触发 ， 方 法 内 部 可 在 页 面 上 显示 处 理 结果 。 该 方法 在 
doInBackground 方法 执行 完毕 后 调用 ， 输 入 参数 对 应 doInBackground 方法 的 输出 参数 。 
onCancelled :调用 任务 对 象 的 cancel 方法 时 触发 。 表 示 取 消 任务 并 返回 。 


另外 ，AsyncTask 有 如 下 可 直接 调用 的 启 停 方法 。 


@@ execute: 开始 执行 异步 处 理 任务 。 
eexecuteOnExecutor: 以 指定 的 线程 池 模式 执行 任务 。AsyncTask 内 置 的 线程 池 模式 有 以 


下 两 个 。 

> AsyncTaskTHREAD POOL _EXECUTOR: 表示 异步 线程 池 (各 任务 间 没有 先后 顺序 ， 即 
有 可 能 某 任务 在 后 面 调用 却 先 执行 )。 

> AsyncTask.SERIAL_EXECUTOR: 表示 同步 线程 池 ( 各 任务 按照 代码 调用 的 先后 顺序 依次 
排队 等 待 执行 )，execute 方法 默认 使 用 SERIAL_EXECUTOR。 

publishProgress: 更 新 进度 。 该 方法 只 能 在 doInBackground 方法 中 调用 ， 调 用 后 会 触发 

onProgressUpdate 方法 。 


e@ get: 获取 处 理 结果 。 
e@ cancel: 取消 任务 。 该 方法 调用 后 ，doInBackground 方法 中 的 处 理 可 能 不 会 马上 停止 ; 若 


想 立即 停止 处 理 ， 则 可 在 doInBackground 方法 中 加 入 isCancelled 的 判断 。 


e@ isCancelled: 判断 该 任务 是 否 取消 。true 表示 取消 ，false 表示 未 取消 。 
e@ getStatus: 获取 任务 状态 。 任 务 状态 的 取 值 说 明 见 表 10-1。 
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表 10-1 任务 状态 的 取 值 说 明 









所 处 时 刻 
onPreExecute 处 理 之 前 〈 正 在 等 待 ) 

onPreExecute、doInBackground、onPostExecute 运行 期 间 
onPostExecute 处 理 结束 


AsyncTask.Status 类 的 任务 状态 
PENDING 

RUNNING | 正在 执行 
FINISHED 


















下 面 是 一 个 异步 加 载 请 求 任务 的 代码 : 


public class ProgressAsyncTask extends AsyncTask<String, Integer, String> { 
private String mBook;”// 书籍 名 称 


public ProgressAsyncTask(String title) { 
super(); 
mBook = title; 

! 


// 线程 正在 后 台 处 理 
protected String doInBackground(String.… params) { 
int ratio = 0; 
for (; ratio <= 100; ratio += 5) { 
ty 
Thread.sleep(200); / 睡眠 200 毫秒 模拟 网 络 通信 处 理 
} catch (InterruptedException e) { 
e.printStackTrace(); 
} 
/ 通报 处 理 进展 。 调 用 该 方法 会 触发 onProgressUpdate 函数 
publishProgress(ratio); 
} 
return params[0]; // 返回 参数 是 书籍 的 名 称 


/ 准备 启动 线程 

protected void onPreExecute() { 
/ 触发 监听 器 的 开始 事件 
mListener.onBegin(mBook); 


} 


/ 线程 在 通报 处 理 进展 

protected void onProgressUpdate(Integer... values) { 
/ 触发 监听 器 的 进度 更 新 事件 
mListener.onUpdate(mBook, values[0], 0); 
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/ 线程 已 经 完成 处 理 

protected void onPostExecute(String result) { 
// 触发 监听 器 的 结束 事件 
mListener.onFinish(result); 

b 


// 线程 已 经 取消 

protected void onCancelled(String result) { 
/ 触发 监听 器 的 取消 事件 
mListener.onCancel(result); 

} 


private OnProgressListener mListener; / 声明 一 个 进度 更 新 的 监听 器 对 象 
/ 设置 进度 更 新 的 监听 器 
public void setOnProgressListener(OnProgressListener listener) { 

mListener = listener; 


由 


/ 定义 一 个 进度 更 新 的 监听 器 接口 
public interface OnProgressListener { 
/ 在 线程 处 理 结束 时 触发 
void onFinish(String result); 
/ 在 线程 处 理 取消 时 触发 
Void onCancel(String result); 
/ 在 线程 处 理 过 程 中 更 新 进度 时 触发 
Void onUpdate(String request, int progress, int sub_progress); 
/ 在 线程 处 理 开始 时 触发 
void onBegin(String request); 


} 
在 Activity 中 调用 异步 任务 的 完整 代码 如 下 : 


public class AsyncTaskActivity extends AppCompatActivity implements OnProgressListener { 
private TextView tv_async; 
private ProgressBar pb async; / 声明 一 个 进度 条 对 象 
private ProgressDialog mDialog; // 声明 一 个 进度 对 话 框 对 象 
public int mShowStyle; / 显示 风格 
public int BAR_HORIZONTAL = 1; // 水 平 条 
public int DIALOG_CIRCLE = 2; / 圆圈 对 话 框 
public int DIALOG_HORIZONTAL = 3; // 水 平 对 话 框 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
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super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_asynce task); 
tv_async=findViewById(R.id.tv_async); 

/ 从 布局 文件 中 获取 名 叫 pb_async 的 进度 条 
pb_async = findViewById(R.id.pb_async); 
initBookSpinner0; / 初始 化 书籍 选择 下 拉 框 


// 初始 化 书籍 选择 下 拉 框 

private void initBookSpinner() { 
ArrayAdapter<String> styleAdapter = new ArrayAdapter<String>(this, 

R.layout.item select, bookArray); 

Spinner sp_style = findViewById(R.id.sp_style); 
sp_style.setPrompt(" 请 选择 要 加 载 的 小 说 "); 
sp_style.setAdapter(styleAdapter); 
sp_style.setOnIltemSelectedListener(new StyleSelectedListener()); 
sp_style.setSelection(0); 

b 


private String[] bookArray = {" 三 国 演义 ", "西游 记 ", "红楼 梦 "}; 
Private int[] styleArray = {BAR_ HORIZONTAL, DIALOG CIRCLE, DIALOG HORIZONTAL}; 
class StyleSelectedListener implements OnItemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
startTask(styleArray[arg2], bookArray[arg2]); / 启动 书籍 加 载 线程 


public void onNothingSelected(AdapterView<?> arg0) {} 
/ 


/ 启动 书籍 加 载 线程 
Private void startTask(int style, String msg) { 
mShowStyle = style; 
/ 创建 一 个 书籍 加 载 线程 
ProgressAsyncTask asyncTask = new ProgressAsync Task(msg); 
/ 设置 书籍 加 载 监听 器 
asyncTask.setOnProgressListener(this); 
/ 把 书籍 加 载 线程 加 入 到 处 理 队列 
asyncTask.execute(msg); 
} 


// 关闭 对 话 框 
private void closeDialog() { 
让 (mDialog != null && mDialog.isShowing()) { / 对 话 框 仍 在 显示 
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mDialog.dismiss(); // 关闭 对 话 框 
上 


/ 在 线程 处 理 结束 时 触发 

public void onFinish(String result) { 
String desc = String.format(" 您 要 阅读 的 《%s》 已 经 加 载 完 毕 ", resul0); 
tv_async.setText(desc); 
closeDialog(0; / 关闭 对 话 框 

} 


// 在 线程 处 理 取 消 时 触发 

public void onCancel(String result) { 
String desc = String.format(" 您 要 阅读 的 《%s》 已 经 取消 加 载 ", resulb); 
tv_async.setText(desc); 
closeDialog(); / 关闭 对 话 框 

' 


/ 在 线程 处 理 过 程 中 更 新 进度 时 触发 
public void onUpdate(String request, int progress, int sub_progress) { 
String desc = String.format("%s 当前 加 载 进度 为 %d%%", request, progress); 
tv_async.setText(desc); 
让 (mShowStyle 一 BAR_HORIZONTAL) { // 水 平 条 
pb_async.setProgress(progress); // 设置 水 平 进度 条 的 当前 进度 
pb_async.setSecondaryProgress(sub_progress); / 设置 水 平 进度 条 的 次 要 进度 
} else if (mShowStyle 一 DIALOG_HORIZONTAL) { // 水 平 对 话 框 
mDialog.setProgress(progress); / 设置 水 平 进度 对 话 框 的 当前 进度 
mDialog.setSecondaryProgress(sub_progress); // 设置 水 平 进度 对 话 框 的 次 要 进度 


/ 在 线程 处 理 开 始 时 触发 
public void onBegin(String request) { 
tv_async.setText(request + "开始 加 载 "); 
让 (mDialog 一 nulll| !mDialog.isShowing0) { // 进度 框 未 弹出 
if (mShowStyle — DIALOG CIRCLE){ // 对 话 框 
/ 弹出 带 有 提示 文字 的 圆圈 进度 对 话 框 
mDialog = ProgressDialog.show(this, " 稍 等 ", request + "页 面 加 载 中 ……"); 
} else if (mShowStyle 一 DIALOG_HORIZONTAL) { // 水 平 对 话 框 
mDialog = new ProgressDialog(this); // 创建 一 个 进度 对 话 框 
mDialog.setTitle(" 稍 等 ");。// 设置 进度 对 话 框 的 标题 文本 
mDialog.setMessage(request + "页 面 加 载 中 ……"); / 设置 进度 对 话 框 的 内 容 文本 
mDialog.setIcon(R.drawable.ic_search); / 设置 进度 对 话 框 的 图 标 
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mDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL); /设置 对 话 框 样式 
mDialog.show0; / 显示 进度 对 话 框 


} 

异步 处 理 任 务 结合 进度 对 话 框 的 展示 效果 如 图 。 著 时 时 
10-9、 图 10-10、 图 10-11 所 示 。 其 中 ， 图 10-9 所 示 | 请 选择 要 加 载 的 小 说 
为 在 页 面 上 嵌入 进度 条 的 执行 界面 ， 图 10-10 所 示 为 
圈 样 式 的 进度 对 话 框 执行 界面 ， 图 10-11 所 示 为 长 
条 样式 的 进度 对 话 框 执行 界面 。 图 10-9 异步 任务 结合 进度 条 的 界面 


三 国 演义 当前 加 载 进 度 为 35% 




















QQ 稍 等 
红楼 梦 页 面 加 载 中 





西游 记 页 面 加 载 中 





15/100 





10-10 ”异步 任务 结合 转圈 样式 的 界面 图 10-11 异步 任务 结合 长 条 样式 的 界面 


AsyncTask 在 简单 场合 已 经 足够 使 用 ， 如 果 要 用 于 大 量 并 发 处 理 ， 就 需要 十 分 小 心 ， 因 为 
AsyncTask 的 设计 不 其 完美， 使 用 过 程 中 要 注意 以 下 两 点 : 

(1) AsyncTask 默认 的 线程 池 模 式 是 SERIAL_EXECUTOR， 即 按照 先后 顺序 依次 调用 。 
假设 有 两 个 网 络 请 求 任务 , 第 一 个 是 文件 下 载 , 第 二 个 是 接口 调用 ,那么 接口 调用 任务 会 等 待 
文件 下 载 完毕 后 执行 ， 而 不 是 在 调用 时 立刻 执行 。 

(2) 由 于 顺序 模式 存在 排队 等 待 的 情况 ， 因 此 Android 提供 了 executeOnExecutor 方法 ， 
允许 开发 者 指定 任务 线程 池 。 不 过 AsyncTask 自 带 的 THREAD_ POOL_EXECUTOR 也 存在 瓶 
颈 ， 该 线程 池 模 式 的 最 大 线程 个 数 是 CPU 个 数 的 两 倍 再 加 1 (参见 AsyncTask 的 源码 
“MAXIMUM_POOL SIZE = CPU COUNT * 2 + 1”) 。 如 果 用 户 手机 采用 了 双核 CPU， 那 
么 AsyncTask 的 最 大 并 发 线程 数 为 2*2+1=5 个 ， 此 时 若 并 发 任务 数 超过 5 个 ， 则 后 面 进来 的 
任务 只 能 排队 等 待 。 如 果 用 户 手 机 采用 的 是 四 核 CPU，AsyncTask 的 最 大 并 发 线程 数 就 为 
4*2+1=9 个 ， 因 此 CPU 个 数 越 多 ，App 运行 越 流畅 是 有 软件 依据 的 。 


10.1.4 ”异步 服务 IntentService 


服务 Service 虽然 是 在 后 台 运行 ， 但 跟 Activity 一 样 都 在 主线 程 中 ， 如 果 后 台 运 行 着 的 服 
务 挂 起 , 用 户 界 面 就 会 卡 着 不 动 , 俗称 死机 。 后台 服务 经 常 要 做 一 些 耗 时 操作 ,比如 批量 处 理 、 
文件 导入 、 网 络 访问 等 ， 此 时 不 应 该 影响 用 户 在 界面 上 的 操作 ， 而 应 该 开启 分 线程 执行 耗 时 操 
作 。 可 以 通过 Thread+Handler 机 制 实现 异步 处 理 ， 也 可 以 通过 Android 封装 好 的 异步 服务 
IntentService 处 理 。 
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使 用 IntentService 有 两 个 好 处 ， 一 个 是 免 去 复杂 的 消息 通信 流程 ; 另 一 个 是 处 理 完成 后 无 


须 手 工 停止 服务 , 开发 者 可 集中 精力 进行 业务 逻辑 的 编码 。 话 虽 如 此 , 我 们 还 是 有 必要 了 解 一 
下 IntentService 的 具体 实现 ， 入 了 这 行 一 般 都 要 干 上 许多 年 ， 晚 学 不 如 早 学 。 前 面 提 到 ， 处 理 
器 对 象 位 于 主线 程 中 ， 分 线程 通过 Handler 对 象 通知 主线 程 ， 然 后 主线 程 执 行 Handler 对 象 的 
handleMessage 方法 刷新 界面 。 反 过 来 也 是 允许 的 ， 即 处 理 器 对 象 位 于 分 线程 中 ， 主 线程 通过 
Handler 对 象 通知 分 线程 ， 然 后 分 线程 执行 Handler 对 象 的 handleMessage 方法 进行 耗 时 处 理 。 


| 





具体 请 看 IntentService 的 实现 步骤 。 
人 EDi 创建 异步 服务 时 ,初始 化 分 线程 的 Handler 对 象 , 注意 下 面 源码 的 thread.getLooper 方法 : 


public void onCreate() { 
super.onCreate(); 
HandlerThread thread = new HandlerThread("IntentService[" + mName + "]"); 
thread. start(); 
mServiceLooper = thread.getLooper(); 
mServiceHandler = new ServiceHandler(mServiceLooper); 
) 


C02 异步 服务 开始 运行 时 ， 通 过 Handler 对 象 将 请 求 数据 送 给 分 线程 ， 源 码 如 下 : 


public void onStart(Intent intent int startId) { 
Message msg = mServiceHandler.obtainMessage(); 
msg.argl] = startld; 
msg.obj = intent; 
mServiceHandler.sendMessage(msg); 


(303 分 线程 在 Handler 对 象 的 handleMessage 方法 中 , 先 通过 onHandleIntent 方法 执行 具体 的 











有 务 处 理 ， 再 调用 stopSelf 结束 指定 标识 的 服务 。 源 码 如 下 : 

















private final class ServiceHandler extends Handler { 

public ServiceHandler(Looper looper) { 
super(looper); 

} 

(WOverride 

public void handleMessage(Message msg) { 
onHandleIntent((Intent)msg.obj); 
stopSelftmsg.argl); 


上 
了 解 IntentService 的 实现 思想 后 ， 使 用 过 程 中 需要 注意 以 下 4 点: 


(1) 增加 一 个 构造 方法 ， 并 分 配 内 部 线程 的 唯一 名 称 。 
(2) onStartCommand 方法 要 调用 父 类 的 onStartCommand， 因 为 父 类 方法 会 向 分 线程 传 
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(3) 耗 时 处 理 的 业务 代码 要 写 在 onHandleIntent 方法 中 , 不 可 写 在 onStartCommand 方法 
中 。 因 为 onHandleIntent 方法 位 于 分 线程 ， 而 onStartCommand 方法 位 于 主线 程 。 

(4) IntentService 实现 了 onStart 方法 ， 却 未 实现 onBind 方法 , 意味 着 异步 服务 只 能 用 普 
通 方式 启 停 ， 不 能 用 绑 定 方式 启 停 。 


下 面 是 使 用 异步 服务 的 代码 : 


public class AsyncService extends IntentService { 
public AsyncServiceO { 
super("com.example.network.service.AsyncService"); 
b 


// onStartCommand 运行 于 主线 程 

public int onStartCommand(Intent intent int flags, int startid) { 
/ 试 试 在 onStartCommand 里 面 沉睡 ， 页 面 按钮 是 不 是 无 法 点 击 了 ? 
return superonStartCommand(intent, flags, startid); 

b 


// onHandleIntent 运行 分 主线 程 
protected void onHandleIntent(Intent intent) { 
// 在 onHandleIntent 这 里 执行 耗 时 任务 ， 不 会 影响 页 面 的 处 理 
try{ 
Thread.sleep(30 * 1000); 
} catch (InterruptedException e) { 
e.printStack Trace(); 
} 


} 


异步 服务 的 演示 效果 如 图 10-12 所 示 ， 即 使 异步 服务 在 onHandleIntent 方法 中 睡眠 30 秒 ， 
也 丝毫 不 影响 用 户 在 页 面 上 的 点 击 操作 。 读 者 可 以 尝试 在 onStartCommand 方法 中 睡眠 30 秒 ， 
看 看 能 否 在 页 面 上 正常 点 击 按钮 。 


点 我 看 看 有 没有 反应 


15:36:11 您 轻 轻 点 了 一 下 下 (异步 服务 正在 运行 ， 不 影响 
您 在 界面 操作 ) 








图 10-12 异步 服务 的 演示 效果 图 
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10.2 ”HTTP 接口 访问 


本 节 介 绍 HTTP 接口 访问 的 相关 技术 与 具体 使 用 ， 首 先 说 明 如 何 利用 连接 管理 器 
ConnectivityManager 检测 网 络 连接 的 状态 ; 然后 阐述 App 用 于 接口 调用 的 移动 数据 格式 JSON 
的 构建 与 解析 ;接着 举例 说 明 通过 HttpURLConnection 实现 基本 的 接口 调用 ,包括 GET 和 POST 
两 种 常见 的 调用 方式 ， 并 给 出 阶段 性 实战 项 目 “ 根 据 经 纬度 获取 地 址 信息 ”的 实现 过 程 ; 最 后 
讲述 利用 HttpURLConnection 从 网 络 获取 小 图 片 的 方法 。 


10.2.1 网 络 连 接 检 查 


谈 到 网 络 通信 ， 首 先 要 检查 当前 是 否 处 于 上 网 状态 ， 然 后 进行 网 络 访问 操作 。 如 果 当 前 
网 络 连接 不 可 用 ,那么 无 须 执行 网 络 访问 ， 直 接 提示 用 户 “ 请 开启 网 络 连接 ”就 好 了 。 要 检测 
网 络 连接 ，Android 会 要 求 App 具备 上 网 权限 ， 所 以 首先 打开 AndroidManifest.xml， 加 上 下 面 
几 行 网 络 权限 配置 : 


<!-- 互联 网 -> 

<uses-permission android:name="android.permission.INTERNET" /> 

<!-- 查看 网 络 状态 -> 

<uses-permission android:name="android.permission.ACCESS_NETWORK _ STATE" /> 
<uses-permission android:name="android.permission.ACCESS_WIFI STATE" /> 


添加 网 络 权 限 配 置 后 ， 可 利用 连接 管理 器 ConnectivityManager 检测 网 络 连 接 ， 该 工具 的 
对 象 从 系统 服务 ContextCONNECTIVITY_SERVICE 中 获取 。 调 用 连接 管理 器 对 象 的 
getActiveNetworkInfo 方法 , 返回 一 个 NetworkInfo 实例 , 通过 该 实例 可 获取 详细 的 网 络 连接 信 
息 。 下 面 是 NetworkInfo 的 常用 方法 。 


e@ getType: 获取 网 络 类 型 。 网 络 类 型 的 取 值 说 明 见 表 10-2。 


表 10-2 ”网络 类 型 的 取 值 说 明 
ConnectivityManager 类 的 网 络 类 型 
TYPE_ WIFI 
TYPE MOBILE 
TYPE_WIMAX 
TYPE ETHERNET 
TYPE BLUETOOTH 
TYPE VPN 


。 getState: 获取 网 络 状态 。 网 络 状态 的 取 值 说 明 见 表 10-3。 
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表 10-3 ”网 络 状态 的 取 值 说 明 
Networklnfo.State 的 网 络 状态 





CONNECTING 





CONNECTED 





SUSPENDED 





DISCONNECTING 





DISCONNECTED 








UNKNOWN 


egetSubtype: 获取 网 络 子 类 型 。 当 网 络 类 型 为 数据 连接 时 ， 子 类 型 为 2G/3G/4G 的 细 分 类 
型 ， 如 CDMA、EVDO、HSDPA、LTE 等 。 网 络 子 类 型 的 取 值 说 明 见 表 10-4。 


表 10-4 网 络 子 类 型 的 取 值 说 明 
































取 值 TelephonyManager 类 的 网 络 子 类 型 制式 分 类 
1 NETWORK_TYPE GPRS 2G 
2 NETWORK_TYPE EDGE 2G 
3 NETWORK_TYPE_UMTS 3G 
4 NETWORK TYPE_ CDMA 2G 
5 NETWORK TYPE EVDO 0 3G 
6 NETWORK_TYPE_EVDO_A 3G 
7 NETWORK_TYPE_1xRTT 2G 
8 NETWORK_TYPE_HSDPA 3G 
9 NETWORK_TYPE HSUPA 3G 
10 NETWORK_TYPE_HSPA 3G 
11 NETWORK_TYPE IDEN 2G 
12 NETWORK_TYPE_EVDO_B 3G 
13 NETWORK TYPE LTE 4G 
14 NETWORK_TYPE_EHRPD 3G 
15 NETWORK_TYPE_HSPAP 3G 
16 NETWORK_TYPE_GSM 2G 
到 NETWORK_TYPE_TD_SCDMA 3G 
18 NETWORK_TYPE_IWLAN 4G 





网 络 连接 的 检测 结果 如 图 10-13 和 图 10-14 所 示 。 其 中 ， 图 10-13 表示 当前 处 于 WiFi 环 
境 ， 图 10-14 表示 当前 使 用 4G 类 型 的 数据 连接 上 网 。 





当前 网 络 连接 的 状态 是 已 连接 
当前 联网 的 网 络 类 型 是 WIFI 


当前 网 络 连 接 的 状态 是 已 连接 
当前 联网 的 网 络 类 型 是 LTE 4G 





10-13 ”连接 WiFi 的 检测 结果 图 





图 10-14 数据 连接 的 检测 结果 图 


第 10 章 网 络 通信 | 425 





10.2.2 ”移动 数据 格式 JSON 


网 络 通 信 的 交互 数据 格式 有 两 大 类 ， 分别 是 JSON 和 XML， 前 者 短小 精 悍 ， 后 者 表现 力 
丰富 。 对 于 App 来 说 ， 基 本 采用 JSON 格式 与 服务 器 通信 。 原 因 很 多 ， 一 个 是 手机 流量 很 贵 ， 
表达 同样 的 信息 ，JSON 串 比 XML 串 短 很 多 ， 在 节省 流量 方面 占 了 上 风 ; 另 一 个 是 JSON 串 
解析 得 更 快 ， 也 更 省 电 ，XML 不 但 慢 而 且 耗 电 。 于 是 ，JSON 格式 成 了 移动 端 事 实 上 的 网 络 
数据 格式 标准 。 

Android 自 带 JSON 解析 工具 ， 提 供 对 JSONObject (JSON 对 象 ) 和 JSONArray (JSON 
数组 ) 的 解析 处 理 。 


1. JSONObject 
下 面 来 看 JSONObject 的 常用 方法 。 


JSONObject 构造 函数 : 从 指定 字符 串 构造 一 个 JSONObject 对 象 。 
getJSONObject: 获取 指定 名 称 的 JSONObject 对 象 。 

getString: 获取 指定 名 称 的 字符 串 。 

getInt: 获取 指定 名 称 的 整 型 数 。 

getDouble: 获取 指定 名 称 的 双 精 度数 。 

getBoolean: 获取 指定 名 称 的 布尔 数 。 

geUSONArray: 获取 指定 名 称 的 JSONArray 数组 对 象 。 

put: 添加 一 个 JSONObject 对 象 。 

toString: 把 当前 的 JSONObject 对 象 输出 为 一 个 JSON 字符 串 。 


2. JSONArray 
下 面 来 看 JSONArray 的 常用 方法 。 


e length: 获取 JSONArray 数组 的 长 度 。 
egeUSONObject: 获取 JSONArray 数组 在 指定 位 置 的 JSONObject 对 象 。 
e put: 往 JSONArray 数组 中 添加 一 个 JSONObject 对 象 。 


下 面 是 使 用 JSON 串 的 代码 片段 ， 包 括 如 何 构造 JSON 串 和 如 何 解析 JSON 串 : 


/ 获取 一 个 手动 构造 的 JSON 串 
Private String getsonStrO { 
String str =""; 
// 创建 一 个 JSON 对 象 
JSONObject obj = new JSONObiect(); 
ty { 
/ 添加 一 个 名 叫 name 的 字符 串 参 数 
obj.put("name", "address"); 
// 创建 一 个 JSON 数组 对 象 
JSONArray array = new JSONArray(); 
for(inti=0;i<3;it+) { 
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JSONObject item = new JSONObiject0; 
/ 添加 一 个 名 叫 item 的 字符 串 参 数 
item.put("item", "第 " + (i+ 1) + "个 元 素 7); 
/ 把 item 这 个 JSON 对 象 加 入 到 JSON 数组 
array.put(item); 
} 
/ 添加 一 个 名 叫 list 的 数组 参数 
obj.put("list", array); 
/ 添加 一 个 名 叫 count 的 整 型 参数 
obj.put("count", array.length()); 
// 添加 一 个 名 叫 desc 的 字符 串 参数 
obj.put("desc", "这 是 测试 串 "); 
// 把 JSON 对 象 转换 为 JSON 字符 串 
str = obj.toString(); 
} catch (JSONException e) { 
e.printStack Trace(); 
} 
return str; 


F 


/ 解析 JSON 串 内 部 的 各 个 参数 
private String parserJson(String jsonStr) { 
String result = ""; 
try{ 
/ 根据 JSON 串 构建 一 个 JSON 对 象 
JSONObject obj = new JSONObject(jsonStr); 
String name = obj.getString("name"); // 获得 名 叫 name 的 字符 串 参 数 
String desc = obj.getString("desc"); / 获得 名 叫 desc 的 字符 串 参 数 
int count = obj.getInt("count"); / 获得 名 叫 count 的 整 型 参数 
result = String.format("%sname=%s\n", result, name); 
result = String.format("%sdesc=%s\n", result desc); 
result = String.format("%scount=%d\n", result, count); 
/ 获得 名 叫 list 的 数组 参数 
JSONArray listArray = obj.getJSONArray("list"); 
for(inti= 0;i<listArray.lengthO: i++) { 
/ 获得 数组 中 指定 下 标的 JSON 对 象 
JSONObject list_item = listArray.geUSONObject(iD; 
// 获得 名 叫 item 的 字符 串 参数 
String item = list_item.getString("item"); 
result = String.format("%s\titem=%s\n", result, item); 
} 
} catch (JSONException e) { 
e.printStack Trace(); 
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示例 代码 对 应 的 效果 如 图 10-15 和 图 10-16 所 示 。 其 中 ， 图 10-15 所 示 为 构造 JSON 串 
结果 界面 ， 图 10-16 所 示 为 解析 JSON 串 的 结果 界面 。 


Ec 


network 










构造 JSON 串 解析 JSON 串 遍历 JSON 串 构造 JSON 串 解析 JSON 串 遍历 JSON 串 
{"count":3,"ist"[{"item":" 第 1 个 元 素 "),{"item":" 第 2 个 元 name=address 
素 "}{ritem":" 第 3 个 元 素 "]"desc"" 这 是 测试 desc= 这 是 测试 串 
串 ""name":"address"} count=3 
item= 第 1 个 元 素 
item= 第 2 个 元 素 


item= 第 3 个 元 素 





图 10-15 ”构造 JSON 串 的 结果 图 图 10-16 解析 JSON 串 的 结果 图 
10.2.3 JSON 串 与 实体 类 自动 转换 


上 一 小 节 提 到 JSONObject 对 JSON 串 的 手工 解析 没有 什么 好 办 法 ， 其 实 是 有 更 高 层次 的 
办 法 。 手 工 解析 JSON 串 实 在 是 麻烦 ， 费 时 费力 还 容易 犯错 ， 捷 径 便 是 甩 开 手工 解析 几 条 街 的 
自动 解析 。 

既然 是 自动 解析 ， 首 先 要 制定 一 个 规则 , 约定 JSON 串 有 哪些 元 素 ， 具体 对 应 怎样 的 数据 
结构 ; 其 次 还 得 有 个 自动 解析 的 工具 ,俗话 说 得 好 ， 没 有 金刚 钼 、 不 揽 瓷 器 活 。 对 于 捷径 第 一 
要 素 的 JSON 数据 结构 定义 ， 就 是 常见 的 bean 实体 类 ， 里 面 定 义 了 每 个 参数 的 数据 类 型 和 参 
数 名 称 。 接 着 解决 捷径 第 二 要 素 的 工具 使 用 ，JSON 解析 除了 系统 自 带 的 orgjson， 和 谷歌 公司 
也 提供 了 一 个 增强 库 gson， 专 门 用 于 JSON 串 的 自动 解析 。 不 过 由 于 是 第 三 方 库 ， 因 此 首先 
要 修改 模块 的 build.gradle 文件 ， 在 里 面 的 dependencies 节点 下 添加 下 面 一 行 配置 ， 表 示 导 入 
指定 版 本 的 gson 库 : 

implementation "com.google.code.gson:gson:2.8.2" 

接着 还 要 在 java 源码 的 文件 头 部 添加 如 下 一 行 导入 语句 ， 表 示 后 面 会 用 到 Gson 工具 类 : 

import com.google.gson.Gson; 

完成 了 以 上 两 个 步骤 ,然后 就 能 在 代码 中 调用 Gson 的 各 种 处 理 方法 了 。Gson 常用 的 方法 
有 两 个 , 一 个 方法 名 叫 toJson, 可 把 数据 对 象 转换 为 JSON 字符 串 ; 另 一 个 方法 名 叫 fomJson， 
可 将 JSON 字符 串 自 动 解析 为 数据 对 象 。 

下 面 是 通过 gson 库 实 现 JSON 自动 解析 的 代码 例子 : 

public void onClick(View v) { 

if (v.getId0) 一 R.id.btn_origin json) { 
/ 把 用 户 信息 对 象 mUser 转换 为 JSON 串 


myjJsonStr = new Gson().toJson(mUser); 
tv_json.setText("json 串 内 容 如 下 : m" + mJsonStr); 
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} else if (v.getId() 一 R.id.btn_ convert json) { 
/ 把 JSON 串 转换 为 UserInfo 类 型 的 数据 对 象 newUser 
UserInfo newUser = new Gson().fromJson(mJsonStr, UserInfo.class); 
String desc = String.format("\n\t 姓名 =%swn\t 年 龄 =%dun\t 身高 =%d\n\t 体重 =%f\n\t 婚 否 =%b"， 
newUser.name, newUser.age, newUserheight newUserweight newUser.married); 


tv_json.setText(" 从 json 串 解析 而 来 的 用 户 信息 如 下 : "+ desc); 


} 


上 述 JSON 串 自 动 解析 前 后 的 效果 分 别 如 图 10-17 和 图 10-18 所 示 ， 其 中 图 10-17 展示 了 
待 解析 的 JSON 字符 串 内 容 ， 图 10-18 展示 了 按照 数据 类 格式 自动 解析 之 后 的 各 字段 值 。 


network network 


原始 JSON 串 转换 JSON 串 原始 JSON 串 转换 JSON 串 


json 串 内 容 如 下 ; 从 json 串 解析 而 来 的 用 户 信息 如 下 ; 
{"age":25,"height": 姓名 = 阿 四 
165,"married":false,"name":" 阿 年 龄 =25 
四 ","weight":50.0} 身高 =165 

体重 =50.000000 

婚 否 =false 





图 10-17 自动 解析 前 的 JSON 字符 串 图 10-18 自动 解析 后 的 数据 类 字段 
10.2.4 ”HTTP 接口 调用 


HTTP 接口 调用 的 代码 标准 有 两 个 ， 分别 是 HttpURLConnection 与 HttpClient。 就 像 JSON 
与 XML 的 区 别 一 样 ， 移 动 端的 代码 标准 基本 采用 更 轻 量 级 的 HttpURLConnection。 只 使 用 
HttpURLConnection 就 能 玩 转 几乎 所 有 HTTP 访问 ， 当 然 复杂 的 功能 〈 如 分 段 传 输 、 上 传 等 ) 
得 自己 写 代码 细节 。 
HttpURLConnection 对 象 从 URL 对 象 的 openConnection 方法 获得 。 下 面 来 看 该 对 象 的 常 
用 方法 。 
e@ setRequestMethod: 设置 请 求 类 型 。GET 表示 get 请 求 ，POST 表示 post 请 求 。 
e@ setConnectTimeout: 设置 连接 的 超时 时 间 。 
e@ setReadTimeout: 设置 读 取 的 超时 时 间 。 
”setRequestProperty: 设置 请 求 包 头 的 属性 信息 。 
e@ setDoOutput: 设置 是 否 允 许 发 送 数 据 。 如 果 用 到 getOutputStream 方法 ，setDoOutput 就 
必须 设置 为 ttue。 因 为 POST 方式 肯定 会 发 送 数据 ， 所 以 POST 调用 时 必须 设置 该 方法 。 
e getOutputStream: 获取 HTTP 输出 流 。 调 用 该 函数 返回 一 个 OutputStream 对 象 ， 接 着 依 
次 调用 该 对 象 的 write 和 flush 方法 写 入 要 发 送 的 数据 。 
e@ connect: 建立 HTTP 连接 。 该 方法 在 getOutputStream 后 调用 ,在 getInputStream 前 调用 。 
e setDoInput: 设置 是 否 允 许 接收 数据 。 如 果 用 到 getInputStream 方法 ，setDoInput 就 必须 
设置 为 true (其实 也 不 必 手动 设 置 ， 因 为 默认 就 是 tue) 。 
e getInputStream: 获取 HTTP 输入 流 。 调 用 该 函数 返回 一 个 mputStream 对 象 ， 接 着 调用 
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该 对 象 的 read 方法 读 出 接收 的 数据 。 


getResponseCode: 获取 HTTP 返回 码 。 
getHeaderField: 获取 应 答 数 据 包头 的 指定 属性 值 。 
getHeaderFields: 获取 应 答 数 据 包 头 的 所 有 属性 列表 。 
disconnect: 断 开 HTTP 连接 。 


HTTP 接口 调用 主要 有 GET 和 POST 两 种 方式 ，GET 方式 只 是 简单 的 数据 获取 操作 ， 类 
似 于 数据 库 的 查询 操作 ; POST 方式 有 提交 具体 的 表单 信息 ， 类 似 于 数据 库 的 增 、 删 、 改 操作 。 
两 种 接口 调用 都 有 固定 的 代码 模板 ， 直 接 套 用 即 可 。 下 面 是 HTTP 接口 调用 的 代码 片段 , 完整 
代码 参见 本 书 附带 源码 network 模块 的 HttpRequestUtiljava: 
/ 设置 HTTP 连接 的 头 部 信息 
private static void setConnHeader(HttpURLConnection conn, String method, HttpReqData req_data) 


) 


throws ProtocolException { 
/ 设置 请 求 方式 ， 常 见 的 有 GET 和 POST 两 种 
conn.setRequestMethod(method); 
/ 设置 连接 超时 时 间 
conn.setConnectTimeout(5000); 
/ 设置 读 写 超时 时 间 
conn.setReadTimeout(10000); 
/ 设置 数据 格式 
conn.setRequestProperty("Accept", "*/*"); 
/ 设置 文本 语言 
conn.setRequestProperty("Accept-Language", "zh-CN"); 
/ 设置 编码 格式 
conn.setRequestProperty("Accept-Encoding", "gzip, deflate"); 


/get 文本 数据 
public static HttpRespData getData(HttpReqData req_data) { 


HttpRespData resp_data = new HttpRespData(); 

try 
URL url =new URLCreq_data.urD; 
/ 创建 指定 网 络 地 址 的 HTTP 连接 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
setConnHeader(conn, "GET", req_data); 
conn.connect(); /人 开始 连接 
// 对 输入 流 中 的 数据 进行 解压 ， 得 到 原始 的 应 答 字 符 串 
resp_data.content = StreamTool.getUnzipStream(conn.getInputStream(), 

conn.getHeaderField("Content-Encoding"), req_data.charset); 

resp_data.cookie = conn.getHeaderField("Set-Cookie"); 
conn.disconnect(); // 断 开 连 接 

} catch (Exception e) { 
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e.printStack Trace(); 
resp_data.err msg = e.getMessage(); 
} 
return resp_data; 


正 所 谓 好 事 多 磨 ，HTTP 访问 除了 套用 调用 模板 外 ， 还 要 处 理 好 几 种 特殊 情况 ， 否 则 就 不 
会 正常 工作 。 常 见 的 特殊 情况 有 两 种 ，URL 串 中 对 汉字 的 转 义 处 理 和 返回 内 容 为 压缩 数据 时 
的 解压 处 理 。 


1. URL 串 中 对 汉字 的 转 义 处 理 


使 用 GET 方式 传递 请 求 数据 ,参数 放 在 URL 中 直接 传送 过 去 。 如 果 参 数值 有 汉字 ， 就 进 
行 UTF8 编码 转 义 处 理 ， 比 如 “你 ”要 转 为 “%E4%BD%A0”。 同 理 ， 对 于 服务 器 返回 的 UTF8 
编码 也 要 进行 反 转 义 ， 比 如 “%E4%BD%A0” 要 转 为 “你 ”。 具 体 的 转 义 代码 参见 本 书 下 载 
资源 的 URLtoUTF8.java。 


2. 返回 内 容 为 压缩 数据 时 的 解压 处 理 


HTTP 请 求 的 包头 带 有 AcceptEncoding: gzip,deflate， 表 示 客 户 端 支持 gzip 压缩 。 服 务 器 
可 能 返回 gzip 压缩 的 应 答 数据 ， 此 时 应 答 包 头 中 会 有 Content-Encoding: gzip。 此 时 压缩 数据 
必须 先 解压 才能 正常 读 取 , 未 解压 只 会 读 到 一 堆 乱 码 。 输 入 流 的 gzip 解压 使 用 GZIPInputStream 
工具 类 ， 具 体 的 解压 代码 参见 本 书 下 载 资源 的 StreamTooljava。 

下 面 用 一 个 阶段 性 的 实战 小 项 目 练 练 手 。 第 9 章 在 介绍 定位 功能 时 使 用 定位 管理 器 获取 
手机 的 位 置信 息 ， 包 括 经 度 、 纬 度 、 高 度 等 ， 不 过 用 户 关心 的 是 具体 的 地 址 描述 ， 而 不 是 看 不 
懂 的 经 纬度 。 现 在 我 们 利用 Google Map 的 开放 API， 通 过 HTTP 调用 传 入 经 纬度 的 数值 ， 然 
后 对 方 返 回 一 个 JSON 格式 的 地 址 信息 字符 串 ， 通 过 解析 JSON 串 就 能 得 到 具体 的 地 址 。 

因为 网 络 访问 不 能 在 主线 程 中 进行 ,所 以 要 结合 AsyncTask 与 HttpURLConnection 实现 地 
址 的 异步 获取 。 获 取 地 址 信息 的 任务 代码 示例 如 下 : 
/ 根据 经 纬度 获取 详细 地 址 的 线程 
public class GetAddressTask extends AsyncTask<Location, Void, String> { 
private String mAddressUrl = 
"http://maps.google.cn/maps/api/geocode/ison?latIng={0},{1}&sensor=true&language=zh-CN"; 
public GetAddressTask() { 
super(); 




















// 线程 正在 后 台 处 理 
protected String doInBackground(Location... params) { 
Location location = params[0]; 
/ 把 经 度 和 纬度 代入 到 URL 地 址 
String url = MessageFormat.format(mAddressUrl, location.getLatitude(), location.getLongitude()); 
/ 创建 一 个 HTTP 请 求 对 象 
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HttpReqData req_data = new HttpReqData(url); 
/ 发 送 HTTP 请 求 信息 ， 并 获得 HTTP 应 答对 象 
HttpRespData resp_data = HttpRequestUtil.getData(req_data); 
String address = "未 知 "; 
// 下 面 从 JSON 串 中 逐 级 解析 formatted_address 字段 获得 详细 地 址 描述 
if (resp_data.err msg.length() <= 0) { 
ty { 
JSONObject obj = new JSONObject(resp_data.content); 
JSONArray resultArray = obj.getJSONArray("results"); 
if (resultArray.length() > 0) { 
JSONObiect resultObj = resultArray.getJSONObject(0); 
address = resultObj.getString("formatted_address"); 
} 
} catch (JSONException e) { 
€.printStackTrace(); 
} 
b 
Teturn address; / 返回 HTTP 应 答 内 容 中 的 详细 地 址 


/ 线程 已 经 完成 处 理 

protected void onPostExecute(String address) { 
/HTTP 调用 完毕 ， 触 发 监听 器 找到 地 址 事件 
mListener.onFindAddress(address); 

由 


private OnAddressListener mListener; / 声明 一 个 查询 详细 地 址 的 监听 器 对 象 
/ 设置 查询 详细 地 址 的 监听 器 
public void setOnAddressListener(OnAddressListener listener) { 

mListener = listener; 


} 


// 定义 一 个 查询 详细 地 址 的 监听 器 接口 
public interface OnAddressListener { 
void onFindAddress(String address); 
} 


接着 在 原来 的 Activity 代码 中 启动 该 任务 , 并 实现 OnAddressListener 接 口 的 onFindAddress 
方法 ， 即 可 在 页 面 上 添加 详细 的 地 址 信息 。 启 动 任务 的 代码 如 下 : 
// 创建 一 个 详细 地 址 查询 的 线程 
GetAddressTask addressTask = new GetAddressTask(); 
// 设置 详细 地 址 查询 的 监听 器 
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addressTask.setOnA ddressListener(this); 
/ 把 详细 地 址 查询 线程 加 入 到 处 理 队 列 
addressTask.execute(location); 


定位 并 获取 地 址 信息 的 效果 如 图 10-19 所 
示 。 此 时 除了 原来 的 经 纬度 数据 外 ， 还 多 了 一 个 
文字 表达 的 详细 地 址 ， 从 省 、 市 、 区 一 直到 具体 定位 类 型 =gps 


的 街道 和 门牌 号 。 如 此 一 来 ， 定 位 功能 的 实用 性 | 吴 和 于 各 信和 如 22.50:20 











误 增强 了 。 其 中 经 度 : 119.332239, 纬度 : 26.145799 

ee 区 扩 10 安 区 秀峰 路 
区 

10.2.5 ”HTTP 图 片 获 取 tl 





除了 HTTP 接口 调用 外 , HttpURLConnection ”图 10-19 通过 HTTP 调用 获得 地 址 信息 的 效果 图 
还 可 用 于 获取 网 络 小 图 片 ， 比 如 验证 码 图 片 、 头 像 图 标 等 ， 这 些小 图 不 大 ， 一 般 也 无 须 缓存 ， 
可 直接 从 网 络 上 获取 最 新 的 图 片 。 

下 面 是 使 用 HttpURLConnection 获取 图 片 的 代码 : 


1/ get 图 片 数据 
public static HttpRespData getImage(HttpReqData req_data) { 

HttpRespData resp_data = new HttpRespData(); 

try{ 
URL url = new URL(req_data.url); 
// 创建 指定 网 络 地 址 的 HTTP 连接 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
setConnHeader(conn, "GET", req_data); 
conn.connect(0); / 开始 连接 
// 从 HTTP 连接 获取 输入 流 
InputStream is = conn.getInputStream(); 
/ 对 输入 流 中 的 数据 进行 解码 ， 得 到 位 图 对 象 
resp_data.bitmap = BitmapFactory.decodeStream(is); 
resp_data.cookie = conn.getHeaderField("Set-Cookie"); 
conn.disconnect(); // 断 开 连 接 

} catch (Exception e) { 
e.printStack Trace(); 
resp_data.err_msg = e.getMessage(); 

} 

return resp_data; 

在 活动 页 面 与 HTTP 图 片 获取 之 间 还 需 一 个 基于 AsyncTask 的 图 片 获取 任务 做 桥梁 。 下 
面 是 获取 图 片 验 证 码 的 任务 代码 : 
/ 获取 图 片 验证 码 的 线程 


public class GetImageCodeTask extends AsyncTask<Void, Void, String> { 
/ 请 求 图 片 验证 码 的 服务 地 址 
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private String mImageCodeUrl = "http://222.77.181.14/ValidateCode.aspx?r="; 
public GetImageCodeTask() { 

super(); 
) 


/ 线程 正在 后 台 处 理 

protected String doInBackground(Void.… params) { 
// 为 验证 码 地 址 添加 一 个 随机 串 〈 以 当前 时 间 模 拟 随机 串 ) 
String url =mImageCodeUrl + DateUtil.getNowDate Time(); 
/ 创建 一 个 HTTP 请 求 对 象 
HttpReqData req_data = new HttpReqData(url); 
/ 发 送 HTTP 请 求 信息 ， 并 获得 HTTP 应 答对 象 
HttpRespData resp_data = HttpRequestUtil.getImage(req_data); 
/ 拼接 一 个 图 片 验 证 码 的 本 地 临时 路 径 
String path = BitmapUtil.getCachePath(MainApplication.getInstance()) + 

DateUtil.getNowDateTime() + "jpg"; 

/ 把 HTTP 调用 获得 的 位 图 数据 保存 为 图 片 
BitmapUtil.saveBitmap(path, resp_data.bitmap, "jpg", 80); 
Teturn path; / 返回 验证 码 图 片 的 本 地 路 径 

) 


/ 线程 已 经 完成 处 理 

protected void onPostExecute(String path) { 
/HTTP 调用 完毕 ， 触 发 监听 器 得 到 验证 码 事件 
mListener.onGetCode(path); 

) 


Private OnImageCodeListener mListener; / 声明 一 个 获取 图 片 验证 码 的 监听 器 对 象 
/ 设置 获取 图 片 验证 码 的 监听 器 
public void setOnImageCodeListener(OnImageCodeListener listener) { 

mListener = listener; 


b 


// 定义 一 个 获取 图 片 验证 码 的 监听 器 接口 
public interface OnImageCodeListener { 
void onGetCode(String path); 
} 
下 面 是 在 页 面 代码 中 调用 验证 码 获 取 任 务 的 代码 片段 ， 首 先 指 定 task 任务 ， 然 后 实现 
onGetCode 方法 显示 验证 码 图 片 : 
/ 获取 图 片 验证 码 
Private void getImageCode0 { 
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if (lisRunning) { 
isRunning = true; 
// 创建 验证 码 获取 线程 
GetImageCodeTask codeTask = new GetImageCodeTask(); 
/ 设置 验证 码 获 取 监听 器 
codeTask.setOnImageCodeListener(this); 
/ 把 验证 码 获取 线程 加 入 到 处 理 队 列 
codeTask.execute(); 


} 


public void onClick(View v) { 
if (v.getld) 一 R.id.iv image code) { 
getImageCode(); / 获取 图 片 验证 码 
} 
b; 


// 在 得 到 验证 码 后 触发 

public void onGetCode(String path) { 
/ 把 指定 路 径 的 验证 码 图 片 显示 在 图 像 视图 上 面 
iv_image_code.setImageURI(Uri.parse(path)); 
isRunning = false; 

} 

从 网 络 上 获取 并 显示 验证 码 图 片 的 效果 如 图 10-20 和 图 10-21 所 示 。 其 中 , 如 图 10-20 所 示 为 
页 面 的 初始 界面 ， 点 击 图 片 后 会 重新 加 载 验证 码 ; 如 图 10-21 所 示 为 验证 码 图 片 刷 新 后 的 界面 。 





network network 
点 击 验证 码 即 可 刷新 验证 码 图 片 点 击 验证 码 即 可 刷新 验证 码 图 片 
图 10-20 ”获取 验证 码 图 片 的 初始 页 面 图 10-21 验证 码 图 片 刷 新 后 的 页 面 
10.3 上 传 和 下 载 


本 节 介 绍 App 与 服务 器 之 间 上 传 文件 和 下 载 文 件 的 实现 与 管理 ， 首 先 对 下 载 管 理 器 
DownloadManager 进行 详细 说 明 ， 包 括 文件 下 载 的 3 个 步骤 、3 种 下 载 事件 以 及 下 载 进度 的 两 
种 查看 方式 〈 通 知 栏 查 看 和 游标 轮 询 ) ; 然后 阐述 基于 Fragment 技术 的 文件 对 话 框 实现 ， 包 
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括 文件 保存 对 话 框 和 文件 打开 对 话 框 两 种 形式 ; 最 后 介绍 通过 HttpURLConnection 的 POST 方 
式 如 何 实现 文件 的 上 传 操作 ， 以 及 上 传 服务 器 的 简单 搭建 过 程 。 


10.3.1 下 载 管理 器 DownloadManager 
10.2 节 提 到 使 用 HttpURLConnection 可 以 获取 小 图 片 ， 不 过 这 么 做 有 诸多 限制 ， 比 如 : 


(1) 无 法 断 点 续 传 ， 一 旦 中 途 失 败 ， 只 能 从 头 开始 获取 。 

(2) 只 能 获取 图 片 ， 不 能 获取 其 他 文件 。 

(3) 不 是 真正 意义 上 的 下 载 操作 ， 没 法 设置 下载 参数 。 

所 以 ，10.2.5 节 的 做 法 只 能 用 于 获取 小 图 ， 如 果 要 下 载 大 图 或 下 载 其 他 格式 的 文件 就 要 另 
想 办 法 。 因 为 下 载 功能 比较 常用 且 业 务 功能 相对 统一 ， 所 以 Android 从 2.3 (API9) 开始 提供 
了 专门 的 下 载 工具 DownloadManager 统一 管理 下 载 操 作 。 

下 载 管理 器 DownloadManager 的 对 象 从 系统 服务 Context.DOWNLOAD_SERVICE 中 获 
取 ， 有 具体 使 用 过 程 分 为 3 步 : 构建 下 载 请 求 、 进 行 下 载 操作 和 查询 下 载 进 度 。 


1. 构建 下 载 请 求 


要 想 使 用 下 载 功能 ， 首 先 得 构建 一 个 下 载 请 求 ， 说 明 从 哪里 下 载 、 下 载 参数 是 什么 、 下 
载 的 文件 保存 到 哪里 等 。 这 个 下 载 请 求 就 是 DownloadManager 的 内 部 类 Request。 下 面 来 看 该 
类 的 常用 方法 说 明 。 

e@ 构造 函数 : 指定 从 哪个 网 络 地 址 下 载 文件 。 

@ ”setAllowedNetworkTypes: 指定 允许 下 载 的 网 络 类 型 .允许 网 络 类 型 的 取 值 说 明 见 表 10-5。 

若 同时 允许 多 种 网 络 类 型 ， 则 可 使 用 竖 线 “|” 把 多 种 网 络 类 型 拼接 起 来 。 


表 10-5 允许 网 络 类 型 的 取 值 说 阴 























DownloadManager.Request 类 的 允许 网 络 类 型 说 明 

NETWORK_ WIFI WiFi 网 络 

NETWORK _ MOBILE 移动 网 络 〈 手 机 的 数据 连接 ) 
NETWORK_ BLUETOOTH 蓝牙 网 络 


esetDestinationInExternalFilesDir: 设置 下 载 文件 在 本 地 的 保存 路 径 。 第 二 个 参数 为 目录 类 
型 ， 取 值 说 明 见 第 4 章 的 表 4-2; 第 三 个 参数 为 不 带 斜 杆 的 文件 名 ; 另外 ， 如 果 指 定 目 
录 已 存在 同名 文件 ， 系 统 就 会 将 新 下 载 的 文件 重 命名 ， 即 在 文件 名 末尾 添加 “-1”“-2? 
之 类 的 序号 。 

addRequestHeader: 给 HTTP 请 求 添 加 头 部 参数 。 

setMimeType: 设置 下 载 文件 的 媒体 类 型 。 一般 无 须 设置 , 默认 是 服务 器 返回 的 媒体 类 型 。 
setTitle: 设置 通知 栏 上 的 消息 标题 。 如 果 不 设置 ， 默 认 标题 就 是 下 载 的 文件 名 。 
setDescription: 设置 通知 栏 上 的 消息 描述 。 如 果 不 设置 ， 就 默认 显示 系统 估算 的 下 载 剩 
余 时 间 。 

@ ”setVisibleInDownloadsUi: 设置 是 否 显示 在 系统 的 下 载 页 面 上 。 
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e setNotificationVisibility: 设置 通知 栏 的 下 载 任务 可 见 类 型 。 可 见 类 型 的 取 值 说 明 见 表 
10-6。 


表 10-6 通知 可 见 类 型 的 取 值 说 明 
DownloadManager.Request 类 的 通知 可 见 类 型 说 明 





VISIBILITY_HIDDEN 隐藏 





VISIBILITY VISIBLE 下 载 时 可 见 〈 下 载 完 成 后 消失 ) 





VISIBILITY VISIBLE NOTIFY_ COMPLETED 下 载 进行 时 与 完成 后 都 可 见 








VISIBILITY VISIBLE NOTIFY_ ONLY_COMPLETION 只 有 下 载 完成 后 可 见 
2. 进行 下 载 操作 
构建 完 下 载 请 求 才能 进行 下 载 的 相关 操作 。 下 面 是 DownloadManager 的 常用 方法 。 
enqueue: 将 下 载 请 求 加 入 任务 队列 中 , 排队 等 待 下 载 。 该 方法 返回 本 次 下 载 任务 的 编号 。 
remove: 取消 指定 编号 的 下 载 任务 。 
restartDownload: 重新 开始 指定 编号 的 下 载 任务 。 
openDownloadedFile: 打开 下 载 完 成 的 文件 。 
getMimeTypeForDownloadedFile: 获取 下 载 完 成 文件 的 媒体 类 型 。 
query: 根据 查询 请 求 获取 符合 条 件 的 结果 集 游标 。 


3. 查询 下 载 进度 


虽然 下 载 进度 可 在 通知 栏 上 查看 ， 但 是 如 果 App 自身 也 想 了 解 当前 的 下 载 进 度 ， 就 要 
调用 下 载 管理 器 的 query 方法 。 该 方法 的 输入 参数 是 一 个 Query 对 象 , 返回 结果 集 的 Cursor 
游标 ， 这 里 的 Cursor 用 法 与 SQLite 里 的 Cursor 一 样 ， 有 具体 可 参考 第 4 章 的 “4.2 数据 库 
SQLite” 。 

下 面 是 Query 类 的 常用 方法 说 明 。 
setFilterById: 根据 编号 过 滤 下 载 任务 。 
setFilterByStatus: 根据 状态 过 滤 下 载 任务 。 
setOnlyIncludeVisibleInDownloadsUi: 是 否 只 包含 在 系统 下 载 页 面 上 的 可 见 任 务 。 
orderBy: 结果 集 按照 指定 字段 排序 。 


设置 完 查 询 请 求 ， 即 可 调用 DownloadManager 对 象 的 query 方法 ， 获 得 结果 集 的 游标 对 
象 。 该 游标 中 包含 下 载 任务 的 完整 字段 信息 ， 主 要 下 载 字段 的 取 值 说 明 见 表 10-7。 


表 10-7 “下载 字段 的 取 值 说 明 


© 0 0 0 0 9。 














DownloadManager 类 的 下 载 字段 说 明 

COLUMN LOCAL FILENAME 下 载 文件 的 本 地 保存 路 径 
COLUMN MEDIA TYPE 下 载 文件 的 媒体 类 型 
COLUMN_TOTAL SIZE BYTES 下 载 文件 的 总 大 小 
COLUMN _ BYTES DOWNLOADED SO FAR 已 下 载 的 文件 大 小 
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( 续 表 ) 
DownloadManager 类 的 下 载 字段 说 明 


COLUMN STATUS 下 载 状态 。 下 载 状态 的 取 值 说 明 见 表 10-8 


表 10-8 ”下载 状 态 的 取 值 说 明 
说 明 

挂 起 ， 即 正在 等 待 
运行 中 

暂停 

成 功 

失败 





DownloadManager 类 的 下 载 状态 
STATUS_ PENDING 
STATUS_RUNNING 

STATUS PAUSED 

STATUS SUCCESSFUL 
STATUS_FAILED 


另外 ， 系 统 的 下 载 服务 还 提供 3 种 下 载 事件 ， 开 发 者 可 通过 监听 对 应 的 广播 消息 进行 相 
应 的 处 理 。3 种 下 载 事 件 说 明 如 下 : 


1. 下 载 完成 事件 


在 下 载 完成 时 ， 系 统 会 发 出 名 为 DownloadManager.ACTION_DOWNLOAD_COMPLETE 
( 值 为 字符 串 android.intentaction.DOWNLOAD_COMPLETE ) 的 广播 ， 因 此 可 注册 一 个 该 广 
播 的 接收 器 ， 用 来 判断 当前 任务 是 否 已 下 载 完 毕 ， 并 进行 后 续 的 业务 处 理 。 


2. 下 载 进 行 时 的 通知 栏 点 击 事件 


在 下 载 过 程 中 ， 只 要 用 户 点 击 通 知 栏 上 的 下 载 任务 ， 系 统 就 会 发 出 行为 名 称 是 
DownloadManager.ACTION_NOTIFICATION_CLICKED ( 值 为 字符 串 android.intent.action. 
DOWNLOAD_NOTIFICATION_CLICKED) 的 广播 ， 可 注册 该 广播 的 接收 器 进行 相关 处 理 ， 
比如 跳 转 到 该 任务 的 下 载 进度 页 面 等 。 


3. 下 载 完成 后 的 通知 栏 点 击 事件 


在 不 同时 刻 点 击 通知 栏 上 的 下 载 任务 会 触发 不 同 的 事件 。 下 载 未 完成 时 点 击 触发 的 是 系 
统 广 播 DownloadManager.ACTION_NOTIFICATION_CLICKED。 下 载 完 成 后 点 击 触发 的 是 系 
统 的 Intent.ACTION_VIEW〔 浏 览 行为 )。 对 于 浏览 行为 ， 系 统 会 根据 媒体 类 型 自动 寻找 对 应 
App 打开 。 因 此 ， 如 果 开 发 者 要 控制 此 时 的 点 击 行为 ， 可 以 调用 Request 对 象 的 setMimeType 
方法 设置 媒体 类 型 ， 这 样 Android 就 会 按照 这 个 类 型 打开 相应 的 App。 
下 面 是 利用 DownloadManager 下 载 APK 安装 包 的 代码 片段 ， 下 载 进度 显示 在 通知 栏 上 : 
class ApkUrlSelectedListener implements OnItemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
证 (isFirstSelecb { / 刚 打开 页 面 时 不 需要 执行 下 载 动作 
isFirstSelect = false; 
Teturn; 




















} 
sp_apk_url.setEnabled(false); 
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/ 根据 安装 包 的 下 载 地址 构建 一 个 Uri 对 象 
Uri uri = Uri.parse(PackageInfo.mUrlArray[arg2]); 
// 创建 一 个 下 载 请 求 对 象 ， 指 定 从 哪个 网 络 地 址 下 载 文件 
Request down = new Request(uri); 
/ 设置 下 载 任务 的 标题 
down.setTitle(PackageInfo.mNameArray[arg2] + "下 载 信 息 "): 
/ 设置 下 载 任务 的 描述 
down.setDescription(PackageInfo.mNameArray[arg2] + "安装 包 正 在 下 载 "); 
// 设置 允许 下 载 的 网 络 类 型 
down.setAllowedNetworkTypes(Request.NETWORK MOBILE 
| Request. NETWORK WIFD; 

/ 设置 通知 栏 在 下 载 进 行 时 与 完成 后 都 可 见 
down.setNotificationVisibility(Request.VISIBILITY_VISIBLE NOTIFY_ COMPLETED); 
/ 设置 要 在 系统 下 载 页 面 显示 
down.setVisibleInDownloadsUi(true); 
/ 设置 下 载 文件 在 本 地 的 保存 路 径 
down.setDestinationInExternalFilesDir( 

DownloadApkActivity.this, Environment.DIRECTORY_ DOWNLOADS, arg2 + ".apk"); 
// 把 下 载 请 求 对 象 加 入 到 下 载 管理 器 的 下 载 队列 中 
mDownloadId = mDownloadManager.enqueue(down); 


public void onNothingSelected(AdapterView<?> arg0) {} 


} 


/ 定义 一 个 下 载 完成 的 广播 接收 器 。 用 于 接收 下 载 完成 事件 


public static class DownloadCompleteReceiver extends BroadcastReceiver { 


public void onReceive(Context context Intent intent) { 


} 


if (intent.getAction().equals(DownloadManager.ACTION DOWNLOAD COMPLETE) 
&&tv_ apk result !=null) { // 下 载 完毕 
/ 从 意图 中 解 包 获得 下 载 编号 
long downId = intentgetLongExtra(DownloadManagerEXTRA_DOWNLOAD ID, -1); 
tv_apk_result.setVisibility(View.VISIBLE); 
/ 拼接 下 载 任务 的 完成 描述 
tv_apk_result.setText(DateUtil.getrNowDateTime() + ”编号 " 
+ downId+ "的 下 载 任务 已 完成 "); 
sp_apk_url.setEnabled(true); 


/ 该 广播 接收 器 用 于 接收 下 载 通知 栏 的 点 击 事件 ， 在 下 载 过 程 中 有 效 ， 下 载 完 成 后 失效 
public static class NotificationClickReceiver extends BroadcastReceiver { 
public void onReceive(Context context, Intent intent) { 
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if (intent.getAction().equals(DownloadManager.ACTION NOTIFICATION_CLICKED) 
&&tv apk result!=nulD) { // 点 击 了 通知 栏 
/ 从 意图 中 解 包 获得 被 点 击 通知 的 下 载 编号 
long[] downIds = intent.getLongArrayExtra( 
DownloadManager. EXTRA NOTIFICATION CLICK DOWNLOAD IDS); 
for (long downld : downIds) { 
让 (downId 一 mDownloadId) { // 找到 当前 的 下 载 任务 
tv_apk_result.setText(DateUtil.getNowDateTime() + " 编号 " 
+ downld + "的 下 载 进度 条 被 点 击 了 一 下 "); 





} 
上 述 代码 接收 并 处 理 了 两 种 下 载 事 件 ， 所 以 要 在 AndroidManifest.xml 中 注册 对 应 类 的 广 
播 信息 ， 具 体 注册 代码 如 下 : 
<!-- 接收 下 载 任务 的 下 载 完成 事件 一 > 


<receiver android:name=".DownloadApkActivity$DownloadCompleteReceiver" > 





<intent-filter> 
<action android:name="android.intent.action.DOWNLOAD COMPLETE" /> 
</intent-filter> 
</receiver> 
<!-- 接收 通知 栏 上 的 下 载 任务 点 击 事件 --> 
<receiver android:name=".DownloadApkActivity$NotificationClickReceiver" > 
<intent-filter> 
<action android:name="android.intent.action.DOWNLOAD NOTIFICATION_CLICKED" /> 
</intent-filter> 


</receiver> 


APK 下 载 的 通知 栏 效果 如 图 10-22 和 图 10-23 所 示 。 其 中 ， 如 图 10-22 所 示 为 下 载 进行 中 
的 通知 栏 界 面 ， 如 图 10-23 所 示 为 下 载 完 成 后 的 通知 栏 界面 。 


艺 下 载 信息 














图 10-22 下 载 进行 中 的 通知 栏 图 10-23 下 载 完成 后 的 通知 栏 
不 想 在 通知 栏 展 示 下 载 进度 ， 而 是 由 App 自身 在 页 面 上 显示 进度 也 是 可 行 的 。 下 面 是 在 
页 面 上 展示 下 载 进度 的 代码 片段 : 
private Handler mHandler = new Handler();”// 声明 一 个 处 理 器 对 象 
// 定义 一 个 下 载 进度 的 刷新 任务 


private Runnable mRefresh = new Runnable() { 
public void run() { 
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boolean isFinished = false; 
/ 创建 一 个 下 载 查询 对 象 ， 按 照 下 载 编号 进行 过 滤 
Query down_query = new Query(); 
/ 设置 下 载 查询 对 象 的 编号 过 滤器 
down query.setFilterById(mDownloadId); 
/ 向 下 载 管理 器 发 起 查询 操作 ， 并 返回 查询 结果 集 的 游标 
Cursor cursor = mDownloadManager.query(down_query); 
while (cursor.moveToNext()) { 
int nameldx = cursor.getColumnIndex(DownloadManager.COLUMN _ LOCAL FILENAME); 
int urildx = cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL URD; 
int mediaTypeIdx = cursor.getColumnIndex(DownloadManager.COLUMN_ MEDIA_TYPE); 
int totalSizeldx = cursor.getColumnIndex( 
DownloadManager.COLUMN TOTAL SIZE BYTES); 
int nowSizeldx = cursorgetColumnIndex( 
DownloadManager.COLUMN _ BYTES DOWNLOADED SO FAR); 
int statusIdx = cursor.getColumnIndex(DownloadManager.COLUMN_STATUS):; 
/ 根据 总 大 小 和 已 下 载 大 小 ， 计 算 当 前 的 下 载 进度 
int progress = (int) (100 * cursor.getLong(nowSizeldx) / cursor.getLong(totalSizeldx)); 
if (cursor.getString(urildx) 一 nulD) { 
break:; 
} 
tpc_progress.setProgress(progress, 100); / 设置 文本 进度 圈 的 当前 进度 
/Android 7.0 之 后 提示 COLUMN_LOCAL FILENAME 已 废弃 
if (Build.VERSION.SDK_INT < Build.VERSION_CODESN) { 
mImagePath = cursor.getString(nameldx); 
} else { // 所 以 7.0 之 后 要 先 获 取 文件 的 Uri， 再 根据 Uri 获取 文件 路 径 
String fileUri = cursor.getString(urildx); 
mlmagePath = Uri.parse(fileUri).getPath(); 
lB 
if(progress 一 100) { / 下 载 完毕 
isFinished = true; 
} 
/ 获得 实际 的 下 载 状态 
int status = isFinished ? DownloadManager.STATUS_SUCCESSFUL : cursor.getInt(statusIdx); 
String desc = ""; 
/ 以 下 拼接 图 片 下 载 任务 的 下 载 详情 
desc = String.format("%s 文件 路 径 : %s\n", desc, mImagePath); 
desc = String.format("%s 媒体 类 型 : %s\n", desc, cursor.getString(mediaTypeIdx)); 
desc = String.format("%s 文件 总 大 小 : %d\n", desc, cursor.getLong(totalSizeIdx)); 
desc = String.format("%s 已 下 载 大 小 : %d\n", desc, cursor.getLong(nowSizeldx)); 
desc = String.format("%s 下 载 进度 : %d%%\n", desc, progress); 
desc = String.format("%s 下 载 状 态 : %s\n", desc, mStatusMap.get(status)); 
tv_image resultsetText(desc); 
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上 

cursorclose(0); / 关闭 数据 库 游标 

让 (tisFinished) { // 未 完成 ， 则 继续 刷新 
/ 延迟 100 毫秒 后 再 次 启动 下 载 进度 的 刷新 任务 
mHandler.postDelayed(this, 100); 

} else { // 已 完成 ， 则 显示 图 片 
sp_image_url.setEnabled(true); 
tpc_progress.setVisibility(View.INVISIBLE); // 隐藏 文本 进度 圈 
/ 把 指定 路 径 的 图 片 显示 在 图 像 视图 上 面 
iv_image_urlsetImageURI(Uri.parse(mImagePath)); 


}; 
上 述 代码 不 在 通知 栏 显 示 下 载 进度 ， 即 将 通知 可 见 类 型 设置 为 VISIBILITY_HIDDEN, 此 
时 需要 在 AndroidManifestxml 中 加 入 对 应 权限 ， 有 具体 的 权限 配置 如 下 : 
<!-- 下 载 时 不 提示 通知 栏 -> 
<uses-permission android:name="android.permission.DOWNLOAD WITHOUT_NOTIFICATION"/> 
在 页 面 上 动态 展示 图 片 下 载 进度 的 效果 如 图 10-24 和 图 10-25 所 示 。 进 度 形式 采用 10.1 
节 介绍 的 文字 进度 圈 , 在 下 载 过 程 中 显示 带 百 分 比 文字 的 进度 圆圈 ,下 载 完 成 后 显示 已 下 载 的 
图 片 。 其 中 ， 图 10-24 所 示 为 刚 开 始 下 载 、 进 度 是 4% 时 的 下 载 页 面 ， 此 时 采用 进度 圆圈 占 位 ; 图 
10-25 所 示 为 下 载 完毕 的 页 面 ， 此 时 占 位 用 的 进度 圆圈 消失 ， 取 而 代 之 的 是 下 载 到 本 地 的 图 片 。 





请 选择 要 下 载 的 图 片 满 庭 芳 














10-24 ” 刚 开始 下 载 图 片 时 的 进度 圈 图 10-25 图 片 下 载 完成 的 界面 
10.3.2 ”文件 对 话 框 
下 载 和 上 传 操作 涉及 文件 的 保存 和 打开 ， 就 像 电脑 上 的 文件 对 话 框 ， 既 可 选择 文件 又 可 
保存 文件 。 然而 Android 没有 提供 现成 的 文件 对 话 框 控件 ,我 们 要 自己 实现 文件 对 话 框 。 有关 
对 话 框 的 自 定义 代码 可 参见 第 6 章 的 “6.3 自 定义 对 话 框 ”， 文件 对 话 框 的 实现 走 的 是 另 一 条 
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路 ， 即 利用 DialogFragment 自 定义 对 话 框 。 

还 记得 第 5 章 的 “5.3 碎片 Fragment” 吧 ，DialogFragment 其 实 是 碎片 Fragment 的 一 个 子 
类 ， 生 命 周 期 和 具体 用 法 可 参照 Fragment。 当 然 ，Fragment 并 非 仅 有 DialogFragment 一 个 子 
类 ， 还 有 其 他 几 个 子 类 ， 分 别 用 在 某 些 特殊 场合 。 下 面 进行 简要 说 明 。 


e DialogFragment: 用 于 对 话 框 的 碎片 。 对 话 框 的 页 面 构建 要 写 在 onCreateDialog 方法 中 。 

e ListFragment: 用 于 列表 的 碎片 ， 目 的 是 取代 ListActivity。 

e@ PreferenceFragment: 用 于 参数 设置 页 面 的 碎片 ， 目 的 是 取代 PreferenceActivity。 比 如 

Android 自 带 的 “系统 设置 ”应 用 使 用 了 PreferenceFragment。 

e WebViewFragment: 用 于 网 页 视图 的 碎片 。 

由 于 文件 对 话 框 的 具体 实现 代码 较 长， 因此 不 贴 在 书 上 了 ， 有 兴趣 的 读者 可 查看 本 书 附 
带 源码 network 模块 的 FileSelectActivity.java 和 FileSaveActivity.java。 

文件 对 话 框 的 展示 效果 如 图 10-26 和 图 10-27 所 示 。 其 中 ， 如 图 10-26 所 示 为 保存 文件 的 
对 话 框 截图 ， 如 图 10-27 所 示 为 打开 文件 的 对 话 框 截图 。 











| la 


| RecordAudio 


Recordvideo 





图 10-26 文件 保存 对 话 框 图 10-27 文件 打开 对 话 框 
考虑 到 文件 对 话 框 是 一 个 通用 控件 ， 并 且 拥 有 统一 风格 的 图 标 、 文 字 与 尺寸 ， 建 议 为 其 
单独 建 一 个 名 为 filedialog 的 新 模块 。 其 他 模块 若 有 用 到 文件 对 话 框 ， 则 可 直接 导入 filedialog， 
无 须 手 工 复制 代码 与 各 类 资源 。 导 入 filedialog 的 办 法 是 ， 打 开 其 他 模块 的 编译 配置 文件 
build.gradle， 在 dependencies 依赖 块 中 增加 如 下 配置 ， 表 示 导 入 filedialog: 
implementation project(':filedialog ) 


10.3.3 文件 上 传 


与 文件 下 载 相 比 ， 文 件 上 传 的 场合 不 是 很 多 ， 通 常用 于 上 传 用 户头 像 、 朋 友 圈 发 布 图 片 
和 视频 动态 等 , 而且 上 传 文件 需要 后 端 服 务 器 配合 ， 容 易 被 开发 者 忽略 。 网 络 通信 少不了 文件 
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上 传 ， 特 别 是 对 于 社交 类 App《〈 如 微 信 、QQ、 微 博 等 ) 来 说 ， 上 传 文件 是 必 不 可 少 的 功能 ， 
因此 有 必要 掌握 文件 上 传 的 相关 技术 。 

很 可 惜 , Android 提供 了 下 载 管理 器 DownloadManager, 却 没 有 提供 专门 的 文件 上 传 工具 ， 
开发 者 得 自己 写 代 码 实现 上 传 功能 。 简单 实现 文件 上 传 其 实 也 不 难 , 一 样 是 按照 HTTP 访问 的 
POST 流程 ， 只 是 要 采取 multipart/form-data 的 方式 分 段 传输 ， 并 加 入 分 段 传输 的 边界 字符 串 。 

通过 HttpURLConnection 实现 文件 上 传 功能 的 代码 量 较 多 , 限于 篇 幅 就 不 贴 在 书 上 了 , 读 
者 可 参考 本 书 附 带 源码 network 模块 的 HttpUploadUtil.java。 利 用 HttpUploadUtil 工具 类 提供 的 
upload 方法 ， 就 能 通过 异步 任务 AsyncTask 进行 文件 上 传 操作 ， 文 件 上 传 任务 的 代码 如 下 : 


/ 上 传 文件 的 线程 
public class UploadHttpTask extends AsyncTask<String, Void, String> { 
public UploadHttpTask() { 
super(); 
b 


(QOverride 
protected String doInBackground(String... params) { 
String uploadUrl = params[0]; / 第 一 个 参数 是 文件 上 传 的 服务 地 址 
String filePath = params[1]; // 第 二 个 参数 是 待 上 传 的 文件 路 径 
/ 向 服务 地 址 上 传 指定 文件 
String result = HttpUploadUtil.upload(uploadUrl, filePath); 
return result; / 返回 文件 上 传 的 结果 
上 


@Override 

protected void onPostExecute(String result) { 
/HTTP 上 传 完毕 ， 触 发 监听 器 的 上 传 结束 事件 
mListener.onUploadFinish(result); 

1 


private OnUploadHttpListener mListener; / 声明 一 个 文件 上 传 的 监听 器 对 象 

/ 设置 文件 上 传 的 监听 器 

public void setOnUploadHttpListener(OnUploadHttpListener listener) { 
mListener = listener; 


} 


// 定义 一 个 文件 上 传 的 监听 器 接口 
public interface OnUploadHttpListener { 
void onUploadFinish(String result); 
} 
} 


注意 文件 上 传 需要 服务 器 配合 ， 即 服务 器 要 开启 HTTP 的 上 传 服务 ， 这 涉及 服务 端 开发 。 














444 | Android Studio 开发 实战 : 从 零 基础 到 App 上 线 (第 2 版 ) 


正 所谓 一 入 IT 深 似 海 ， 学 了 客户 端 还 得 会 服务 端 ， 赶 紧 找 个 做 J2EE 的 同学 帮忙 ， 搭 建 一 下 
HTTP 的 上 传 服务 器 。 若 一 时 找 不 到 帮手 也 没关系 ， 只 要 读者 的 笔记 本 电脑 自 带 无 线 网 卡 ， 就 
能 自己 动手 、 丰 衣 足 食 。 上 传 服务 器 的 具体 搭建 步骤 如 下 : 

G01 在 笔记 本 电脑 上 下 载 并 安装 “360 免费 WiFi” 软 件 , 运行 该 工具 给 电脑 开启 WiFi 热点 ， 
在 工具 界面 上 设置 WiFi 名 称 、 用 户 名 、 密 码 等 信息 。 
302 关闭 Windows 系统 服务 的 防火 墙 。 无 论 是 系统 自 带 的 Windows Firewall， 还 是 其 他 杀 
软件 的 防火 墙 ， 统 统 关 掉 ; 否则 手机 连 不 上 电脑 的 WiFi。 

03 打开 手机 的 WLAN 功能 ， 连 接 电脑 刚 开 的 WiFi， 要 求 手机 能 够 上 网 才 算 连接 成 功 。 

04 在 笔记 本 电脑 上 打开 Eclipse, 导 入 本 书 附带 的 文件 上 传 服 务 端 demo 一 一 NetServer 工程 ; 
右 击 该 工程 并 依次 选择 Run As 一 Run on Server， 启 动 该 工程 。 

人 5 在 命令 窗口 运行 ipconfig /all， 在 结果 中 找到 Microsoft Virtual WiFi Miniport Adapter， 框 
选 部 分 为 手机 观察 到 的 电脑 (如 图 10-28 所 示 )， 也 就 是 App 认可 的 服务 器 人 P。 


[oT x 






























































画 余 令 提示 符 


oft Virtual WiFi Miniport hdapter 
5 -54-A1-C4-38 


DHCPu6 IAI 
DHC = 


CH HUD 





图 10-28 在 命令 行 下 面 找 到 的 电脑 WiFi 的 IP 地址 


在 笔记 本 电脑 上 拱 建 好 模拟 的 HTTP 上 传 服务 
器 ， 再 修改 App 工程 中 的 上 传 地 址 ( 妇 network 








http://192.168.253.1:8080/NetServer/uploadServlet ) ， http://192.168.252.1:8080/NetServer/ 
然后 把 App 安装 到 手机 上 , 就 可 以 在 手机 上 测试 文件 。 L999Sevet 
上 传 功能 了 。 HTTP 上 传 文件 


文件 上 传 的 效果 如 图 10-29 所 示 。 倘 车 上 传 成 功 。 | 上 人 文人 为. storagelemnuiatedi0y 
还 应 给 出 服务 器 对 应 的 文件 下 载 地 址 ， 这 样 才 好 验证 人 由 
上 传 成 功 与 否 。 预计 下 载 地 址 为 : http:/ 
192.168.252.1:8080/NetServer/sd11.jpg 








图 10-29 文件 上 传 成 功 的 效果 图 
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10.4” 套 接 字 Socket 


本 节 介绍 套 接 字 Socket 的 技术 手段 与 具体 用 途 ， 首 先 说 明 如 何 使 用 网 络 地 址 工具 
InetAddress 判断 某 个 网 络 地 址 的 连通 性 ， 然 后 阐述 Socket 技术 在 计算 机 网 络 中 所 处 的 层次 、 
应 用 方向 以 及 基本 用 法 。 


10.4.1 网 络 地 址 InetAddress 


有 些 时 候 , 手机 明明 可 以 上 网 ，App 也 加 了 网 络 访问 权限 ， 可 是 HTTP 请 求 某 个 地 址 却 总 
是 连 不 上 。 遇 到 这 种 情况 ,很 可 能 是 把 对 方 的 地 址 和 弄 错 了 ， 导 致 尝试 连接 一 个 根本 连 不 了 的 地 
址 。 所 以 有 必要 在 发 起 请 求 前 检查 一 下 能 和 否 与 对 方 地址 建立 连接 。 

检查 设备 自身 与 某 个 网 络 地 址 的 连通 性 用 到 了 InetAddress 工具 ， 这 是 对 网 络 地 址 的 一 个 
封装 。 下 面 介绍 该 工具 的 主要 方法 说 明 。 
getByName: 根据 主机 IP 或 主机 名 称 获取 InetAddress 对 象 。 
getHostAddress: 获取 主机 的 IP 地址 。 
getHostName: 获取 主机 的 名 称 。 
isReachable: 判断 该 地 址 是 否 可 到 达 ， 即 是 否 连通 。 
下 面 是 检查 网 络 地 址 能 否 连 通 的 代码 片段 : 

public void onClick(View v) { 
让 (v.getId() 一 R.id.btn_host_name) { // 点 击 了 “检查 主机 名 ”按钮 


/ 启动 主机 检查 线程 
new CheckThread(et_host_name.getText().toString()).start(); 


© 0 0 9 


// 创建 一 个 检查 结果 的 接收 处 理 器 
private Handler mHandler = new Handler() { 
/ 在 收 到 结果 消息 时 触发 
public void handleMessage(Message msg) { 
tv_host_name.setText(" 主 机 检查 结果 如 下 : \n" + msg.obj); 
5 
// 定义 一 个 主机 检查 线程 
private class CheckThread extends Thread { 
private String mHostName; // 主机 名 称 


public CheckThread(String host_name) { 
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mHostName = host_name; 


b 


public void runO) { 
/ 获得 一 个 默认 的 消息 对 象 
Message message = Message.obtain(); 
ty { 
/ 根据 主机 名 称 获得 主机 名 称 对 象 
JInetAddress host = InetAddress.getByName(mHostName):; 
/ 检查 该 主机 在 规定 时 间 内 能 否 连 上 
boolean isReachable = host.isReachable(5000); 
String desc = (isReachable) ? "可 以 连接 " : "无 法 连接 "; 
证 (isReachable) { / 可 以 连接 
desc = String.format("%sN 主机 名 为 %s\n 主机 地 址 为 %s"， 
desc, host.getHostName(), hostgetHostAddress()); 
由 
message.what = 0; // 消息 类 型 
message.obj = desc; // 消息 描述 
} catch (Exception e) { 
e.printStackTrace(); 
message.what = -1; / 消息 类 型 
message.obj = e.getMessage(); / 消息 描述 
} 
// 向 接收 处 理 器 发 送 检查 结果 消息 
mHandler.sendMessage(message); 


} 


检查 网 络 地 址 连通 性 的 效果 如 图 10-30 和 图 10-31 所 示 。 其 中 ， 如 图 10-30 所 示 是 根据 网 
站 域名 检测 连通 性 ， 如 图 10-31 所 示 是 根据 IP 地址 检测 连通 性 。 











www.163.com | 














检查 主机 名 
主机 检查 结果 如 下 : 
可 以 连接 y 
主机 名 为 www.163.com 主机 名 为 192.168.253.1 
主机 地 址 为 183.250.179.133 主机 地 址 为 192.168.253.1 
图 10-30 ”检测 域名 的 连通 性 结果 图 图 10-31 检测 人 P 的 连通 性 结果 图 


10.4.2 ”Socket 通信 
对 于 程序 开发 来 说 , 网 络 通 信 的 基础 就 是 Socket, 不 过 正 因为 是 基础 , 所 以 用 起 来 不 容易 。 
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计算 机 网 络 有 一 个 大 名 易 易 的 TCP/IP 协议 ， 普 通用 国志 生病 启 国 
户 在 电脑 上 设置 本 地 连接 的 卫 时 经 常 看 到 如 图 10-32 || 融 ” 王 本 
所 示 的 弹 窗 , 注意 框 选 部 分 已 经 很 好 地 描述 了 TCP/IP ”| 时 


Realtek PCIe GBE Panily Controller 














协议 的 作用 。 Ew 
TCP/IP 是 一 个 协议 组 ， 分 为 3 个 层次 : 网 络 层 、 | 全 和 
传输 层 和 应 用 层 。 加 Fn herose ft 网 络 的 文件 和 打印 机 共享 | 


回 i 各 8 _GTCP/IPv6) 





。 网 络 层 : 包括 IP 协 议 . ICMP 协议 . ARP 协议 、| | 名 2 2 
RARP 协议 和 BOOTP 协议 。 
e 传输 层 : 包括 TCP 协议 和 UDP 协议 。 





4 

















闻 载 属性 








e 应 用 层 : 包括 HTTP、 FTP、TELNET、 SMTP、 
DNS 等 协议 。 
本 章 之 前 提 到 的 网 络 通信 编程 其 实 都 是 应 用 层 | 





的 HTTP 编程 。Socket 属于 传输 层 的 技术 ， API 实现 
TCP 协议 后 即 可 用 于 HTTP 通信 ， 实 现 UDP 协议 后 
即 可 用 于 FTP 通信 ， 当 然 也 可 以 直接 在 底层 进行 点 对 点 通信 ， 比 如 即时 通信 软件 (QQ、 微 信 ) 
就 是 这 样 。 除 了 即时 通信 ，Socket 技术 也 常常 用 于 在 线 咨 询 、 消 息 推送 等 需要 实时 交互 消息 的 
场合 。 

Android 的 Socket 编程 主要 使 用 Socket 和 ServerSocket 两 个 类 ， 下 面 分 别 进行 介绍 。 


图 10-32 电脑 上 的 本 地 连接 配置 页 面 





1. Socket 


Socket 是 最 常用 的 工具 ， 客 户 端 和 服务 端 都 要 用 到 ， 描 述 了 两 边 对 套 接 字 (Socket) 处 理 
的 一 般 行为 。 下 面 介绍 Socket 的 主要 方法 。 


connect: 连接 指定 IP 和 端口 。 该 方法 用 于 客户 端 连接 服务 端 。 
getInputStream: 获取 输入 流 ， 即 自身 收 到 对 方 发 过 来 的 数据 。 
getOutputStream: 获取 输入 流 ， 即 自身 向 对 方 发 送 的 数据 。 
getInetAddress: 获取 网 络 地 址 对 象 。 该 对 象 是 一 个 InetAddress 实例 。 
isConnected: 判断 socket 是 否 连 上 。 

isClosed: 判断 socket 是 否 关 闭 。 

close: 关闭 socket。 


2. ServerSocket 


ServerSocket 仅 用 于 服务 端 ， 在 运行 时 不 停 地 侦 听 指定 端口 。 下 面 介绍 ServerSocket 的 主 
要 方法 。 


。 构造 函数 : 指定 侦 听 哪个 端口 。 

。 accept: 开始 接收 客户 端的 连接 。 有 客户 端 连 上 时 就 返回 一 个 Socket 对 象 ， 若 要 持续 侦 
听 连 接 ， 则 在 循环 语句 中 调用 该 函数 。 

egetInetAddress: 获取 网 络 地 址 对 象 。 该 对 象 是 一 个 InetAddress 实例 。 
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e@ isClosed: 判断 socket 服务 器 是 否 关闭 。 
@ close: 关闭 socket 服务 器 。 


下 面 通过 具体 代码 演示 Socket 通信 的 案例 ， 详 细 步 又 说 明 如 下 : 
CI01 首先 在 客户 端 与 服务 端 之 间 建 立 Socket 连接 ， 详 细 代 码 如 下 : 


public class MessageTransmit implements Runnable { 
// 以 下 为 Socket 服务 器 的 tp 和 端口 ， 根 据 实际 情况 修改 
private static final String SOCKET IP="192.168.0.212"; 
Private static final int SOCKET PORT= 51000; 
private BufferedReader mReader =null; / 声明 一 个 缓存 读 取 器 对 象 
private OutputStream mWriter =null; / 声明 一 个 输出 流 对 象 


@Override 
public void run() { 
/ 创建 一 个 套 接 字 对 象 
Socket socket = new Socket(); 
try{ 
// 命令 套 接 字 连 接 指定 地 址 的 指定 端口 
socket.connect(new InetSocketAddress(SOCKET IP, SOCKET PORT), 3000); 
/ 根据 套 接 字 的 输入 流 ， 构 建 缓存 读 取 器 
mReader = new BufferedReader(new InputStreamReader(socket.getInputStream())); 
/ 获得 套 接 字 的 输出 流 
mWriter = socket.getOutputStream(); 
// 启动 一 条 子 线程 来 读 取 服务 器 的 返回 数据 
new RecvThread().start(); 
// 为 当前 线程 初始 化 消息 队列 
Looper.prepare(); 
// 让 线程 的 消息 队列 开始 运行 ， 之 后 就 可 以 接收 消息 了 
Looper.loop(); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 


// 创建 一 个 发 送 处 理 器 对 象 ， 让 App 向 后 台 服 务 器 发 送 消息 
public Handler mSendHandler = new HandlerO { 
// 在 收 到 消息 时 触发 
public void handleMessage(Message msg) { 
/ 换行 符 相当 于 回 车 键 ， 表 示 我 写 好 了 发 出 去 吧 
String send msg = msg.obj.toStringO + "m'"; 
ty{ 
/ 往 输出 流 对 象 中 写 入 数据 
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mWriter.write(send_msg.getBytes("utf8")); 
} catch (Exception e) { 
€.printStackTrace(); 


上 


/ 定义 消息 接收 子 线程 ， 让 App 从 后 台 服 务 器 接收 消息 
private class RecvThread extends Thread { 
@Override 
public void run() { 
ty { 
String content; 
/ 读 取 到 来 自 服务 器 的 数据 
while ((content = mReader.readLine()) = null) { 
// 获得 一 个 默认 的 消息 对 象 
Message msg = Message.obtain(); 
msg.obj = content; // 消息 描述 
// 通知 SocketActivity 收 到 消息 
SocketActivity.mHandler.sendMessage(msg); 
} 
} catch (Exception e) { 
e.printStackTrace0; 


} 
人 ED 然后 在 Activity 中 启动 Socket 连接 的 线程 ， 等 待 界面 向 Socket 服务 器 发 送 消息 ， 并 准 
备 接收 消息 ， 完 整 的 页 面 代码 如 下 : 
public class SocketActivity extends AppCompatActivity implements OnClickListener { 
private EditText et_socket; 


private static TextView tv_socket; 
private MessageTransmit mTransmit; // 声明 一 个 消息 传输 对 象 

















protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_socket); 
et_socket = findViewById(R.id.et_socket); 
tv_socket = findViewById(R.id.tv_socket); 
findViewById(R.id.btn_socket).setOnClickListener(this); 
mTransmit = new MessageTransmit0); / 创建 一 个 消息 传输 
new Thread(mTransmit).start0; / 启动 消息 传输 线程 
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b 


public void onClick(View v) { 
if (v.getld() 一 R.id.btn_socket) { 
/ 获得 一 个 默认 的 消息 对 象 
Message msg = Message.obtain(); 
msg.obj =et_socketgetText0.toString(0; / 消息 内 容 
/ 通过 消息 线程 的 发 送 处 理 器 ， 向 后 端 发 送 消息 
mTransmit.mSendHandler.sendMessage(msg); 


// 创建 一 个 主线 程 的 接收 处 理 器 ， 专 门 处 理 服务 器 发 来 的 消息 
public static Handler mHandler = new HandlerO { 
(QOverride 
public void handleMessage(Message msg) { 
if (ty_socket != null) { 
/ 拼接 服务 器 的 应 答 字符 串 
String desc = String.format("%s 收 到 服务 器 的 应 答 消 息 : %s"， 
DateUtil.getNowTime(), msg.obj.toString()); 
tv_socket.setText(desc); 


} 

TI03 最 后 启动 Socket 服务 器 (其 实 一 开始 就 要 启动 ， 这 样 App 运行 时 才能 马上 连 上 后 端 服 
务 器 ) ，Socket 服务 端的 源码 见 本 书 下 载 资源 SocketServer 工程 的 TestServerjava， 服 务 器 搭建 过 程 参 
见 10.3 节 的 “10.3.3 文件 上 传 ”末尾 部 分 。 


Socket 通信 的 效果 如 图 10-33 和 图 10-34 所 示 。 其 中 ， 如 图 10-33 所 示 为 准备 发 送 消息 时 
的 界面 ， 如 图 10-34 所 示 为 点 击发 送 按钮 后 的 界面 。 此 时 App 向 Socket 服务 器 发 送 消息 内 容 
“hello， 你 好 呀 ”，Socket 服务 器 立即 回复 “hi， 很 高 兴 认 识 你 ”， 回 复 内 容 已 即时 显示 在 
App 页 面 上 。 


























hello， 你 好 呀 hello， 你 好 呀 
发 送 消息 发 送 消 息 
17:33:21 收 到 服务 器 的 应 答 消息 ; hi ， 很 高 兴 认 识 你 





图 10-33 ”Socket 消息 发 送 前 的 界面 图 10-34 Socket 消息 发 送 后 的 界面 
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10.5 实战 项 目 : 仿 应 用 宝 的 应 用 更 新 功能 


在 以 PC 为 载体 的 传统 互联 网 时 代 ， 用 户 要 想 找到 感 兴趣 的 网 站 ， 基 本 通过 搜索 引擎 来 寻 
寻觅 竟 。 因 此 屠 时 谁 抓 住 了 搜索 引擎 这 个 入 口 ， 谁 就 能 成 为 互联 网 巨头 , 例如 谷歌 、 百 度 就 是 
榜样 。 在 以 手机 为 载体 的 移动 互联 网 时 代 , 用 户 同样 想 找到 感 兴趣 的 App， 此 时 流行 的 便 是 各 
类 应 用 商店 了 《也 叫 应 用 市 场 、 应 用 超市 等 ) 。 于 是 应 用 商店 成 为 移动 互联 网 的 入 口 ， 作 为 入 
口 必 然 存在 多 样 的 网 络 交互 行为 ， 辟 如 应 用 升级 就 用 到 了 好 几 种 网 络 通信 技术 ， 下 面 就 以 “ 仿 
应 用 宝 的 应 用 更 新 功能 ”这 个 实战 项 目 来 练 练 手 。 


10.5.1 设计 思路 


应 用 宝 是 腾讯 公司 推出 的 应 用 商店 App， 在 它 上 面 安装 其 他 App 要 先 通过 搜索 框 输入 关 
键 字 查询 ， 然 后 在 结果 列表 中 选择 合适 的 App 安装 。 比 如 新 买 了 一 部 手机 ， 赶 紧 安 装 一 个 京 
东 商 城 App,， 看 看 霸道 总 裁 最 近 又 有 什么 花边 新 闻 。 于 是 在 打开 系统 自 带 的 应 用 宝 ， 在 搜索 杠 
中 输入 “京东 ”， 页面 立刻 罗列 相关 的 App 列表 。 发 现 第 一 个 App 正 是 大 名 易 易 的 京东 商城 ， 
马上 点 击 右边 的 “下 载 ” 按钮， 该 按钮 的 文字 变 为 “暂停 ”， 并 且 按钮 区 域 变 成 了 一 根 蓝 色 进 
度 条 ， 提 示 用 户 当前 的 下 载 进度 ， 此 时 应 用 宝 页 面 如 图 10-35 所 示 。 耐 心 等 待 它 下 载 完毕 ， 按 








钮 上 的 文字 又 变 为 “安装 ”， 同 时 按钮 背景 色 变 成 绿色 ， 表 示 该 App 已 经 成 功 下 载 ， 可 以 立 
刻 安 装 了 ， 此 时 应 用 宝 页 面 如 图 10-36 所 示 。 
《< 京东 搜索 《< 床 东 搜索 
全 部 应 用 内 容 评测 全 部 应 用 内 容 评测 
应 用 搜索 结果 应 用 搜索 结果 
Dk EE 京东 ED 


东乡 ,价格 喇 勾 现在 8 有 告别 的 。 基 玉 到 


东西 划 多 价格 虽然 现在 有 特别 的 ”图 利信 
本 加 时 一 估 执 ， 他 丈 是 下 品 ,还 支持 条 玛 -. 


优势 ， 但 好 歹 是 正品 ， 还 支持 条 码 -- 
4.8{Z 人 下 AE 














唯 品 会 加 下 唯 品 会 口 
由 和 二 全 球 精 先 正品 特卖 下 载 由 :所 二 全 球 情 先 正品 特 志 下 载 
图 10-35 ”应 用 宝 正 在 更 新 应 用 图 10-36 应 用 宝 完成 下 载 应 用 


单单 从 界面 上 看 ， 这 个 应 用 安装 功能 似乎 很 简单 ， 不 过 就 是 一 个 下 载 操作 么 。 然 而 这 背 
后 的 学 问 可 大 着 呐 , 例如 : 要 不 要 判断 手机 之 前 是 否 已 经 安装 了 该 App， 如 果 没 安装 ， 则 按钮 
文字 仍 为 “下 载 ”; 如 果 已 经 安装 ， 则 按钮 文字 改 为 “安装 ”。 又 如 : 对 于 App 已 安装 的 情 
况 ， 怎 样 判 断 当前 版 本 是 不 是 最 新 版 本 ? 因为 若是 最 新 版 本 就 无 需 升级 了 。 再 如 ， 在 App 安 
装 包 下 载 的 时 候 ， 系 统 如 何 才 能 得 知 当前 的 下 载 进度 ， 从 而 实时 刷新 进度 条 ? 
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对 照 上 述 的 技术 实现 问题 ， 才 感觉 原来 应 用 更 新 功能 没有 想象 的 容易 ， 其 内 部 至 少 采 用 
了 以 下 的 几 项 网 络 通 信 技 术 : 


e 多 线程 : 所 有 的 网 络 通信 操作 都 要 开启 分 线程 处 理 。 
HTTP 接口 调用 : 应 用 商店 只 能 获取 已 安装 App 的 版 本 号 ， 最 新 的 版 本 号 要 向 服务 器 请 
求 获得 。 
JSON 解析 : 与 服务 器 之 间 的 数据 交互 ， 可 采用 JSON 格式 的 字符 串 。 
HTTP 获取 图 片 : 应 用 商店 发 现 更 新 的 App 安装 包 ， 则 App 图 标 也 可 能 是 新 的 。 
文件 下 载 : 从 应 用 商店 下 载 指定 App 的 安装 包 ， 可 用 系统 自 带 的 下 载 管 理 器 。 
文字 进度 条 : 下 载 过 程 中 按钮 区 域 变 成 蓝 色 进度 条 ， 参 见 前 几 节 提 到 的 文字 进度 条 。 
可 见 应 用 商店 这 个 大 管家 的 工作 也 不 轻松 ， 既 忙 里 又 忙 外 ， 既 上 得 了 厅堂 又 进 得 了 厨房 ， 
有 了 这 个 好 帮手 ， 用 户 才 能 玩 转 那 千 千 万 万 的 众多 App。 


10.5.2 ”小 知识 :查看 APK 文件 的 包 信息 


应 用 超市 给 App 更 新 版 本 的 时 候 ， 注 意 有 种 特殊 的 情况 ， 倘 若 扫 描 存 储 卡 发 现 已 经 存在 
某 App 的 新 版 本 安装 包 , 则 表示 用 户 手 机 里 面 已 经 有 了 新 包 , 此 时 无 需 耗费 流量 即 可 对 该 App 
进行 升级 。 这 个 本 地 安装 包 的 校 验 操作 又 分 为 两 个 步骤 : 扫描 存储 卡 上 的 所 有 APK 文件 ， 以 
及 获取 APK 文件 中 的 包 信息 与 版 本 信息 ， 分 别 说 明 如 下 : 


1. 扫描 存储 卡 上 的 所 有 APK 文件 


第 4 章 介 绍 内 容 解析 器 ContentResolver 的 时 候 ， 提 到 它 可 用 来 查询 系统 的 短信 、 联 系 人 、 
通话 记录 等 通讯 信息 ， 其 实 它 还 有 一 种 妙用 ， 就 是 查找 存储 卡 上 指定 类 型 的 文件 。 比 如 APK 
的 媒体 类 型 是 “application/vnd.android.package-archive ”， 和 那么 通过 条 件 
"mime_type=\"application/vnd.android.package-archive\"" 即 可 筛选 出 存储 卡 上 所 有 属于 APK 的 
安装 包 记录 。 详 细 的 安装 包 信息 包括 文件 名 称 、 文 件 路 径 、 文 件 大 小 等 ， 下 面 是 从 存储 卡 获取 
APK 文件 列表 的 代码 示例 : 

// 获取 设备 上 面 所 有 已 经 存在 着 的 APK 文件 

public static ArrayList<ApkInfo> getAllApkFile(Context context) { 

ArrayList<ApkInfo> appAray = new ArrayList<ApkInfo>(); 
// 查找 本 地 所 有 的 APK 文件 ， 其 中 mime type 指定 了 APK 的 文件 类 型 
Cursor cursor = context.getContentResolver().query( 
MediaStore.Files.getContentUri("external"), 
null, "mime_type=\"application/vnd.android.package-archive\"", null, null); 
if (cursor != nulD { 


while (cursormoveToNextO) { 
// 获取 文件 名 
String title = cursor.getString(cursor.getColumnIndex(MediaStore.Files.FileColumns.TITLE)); 
// 获取 文件 完整 路 径 
String path = cursor.getString(cursor.getColumnIndex(MediaStore.Files.FileColumns.DATA)); 
/ 获取 文件 大 小 
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int size = cursor.getInt(cursor.getColumnIndex(MediaStore.Files.FileColumns.SIZE)); 
// 将 该 记录 添加 到 APK 文件 信息 列表 
appAray.add(new ApkInfo(title, path, size, ™, "", 1)); 
b 
cursor.close(); / 关闭 数据 库 游标 
} 
Teturn appAray; 
} 


2. 获取 APK 文件 中 的 包 信息 与 版 本 信息 


前 面 的 步骤 列举 了 存储 卡 上 已 有 的 APK 文件 路 径 , 但 是 并 不 足以 判断 可 供 哪些 应 用 升级 。 
因为 即便 是 找到 了 几 个 APK 文件 ，App 如 何 甄别 这 些 APK 都 是 什么 来 头 ， 哪 个 APK 文件 才 
符合 当前 应 用 的 指定 版 本 号 ? 所 以 要 想 逐 个 判定 APK 文件 的 真实 身份 ， 还 得 解析 APK 内 部 
的 包 信息 ， 具 体 的 工作 则 是 调用 PackageManager 对 象 的 getPackageArchiveInfo 方法 ， 该 方法 
可 从 指定 的 APK 路 径 获取 安装 包 的 详细 数据 , 包括 应 用 的 包 名 、 应 用 的 版 本 号 等 。 有 了 包 名 、 
版 本 号 这 些 信 息 ， 应 用 超市 方 能 鉴定 本 地 是 否 存 在 最 新 版 本 的 升级 包 。 

下 面 是 从 APK 文件 中 解析 详细 包 信 息 的 代码 例子 : 
/ 获取 指定 文件 的 安装 包 信息 
public static ApkInfo getApkInfo(Context context, String path) { 
ApklInfo info = new ApkInfo(); 
PackageManager pm = context.getPackage Manager(); 
/ 从 指定 路 径 的 APK 文件 中 解析 应 用 的 包 信息 ， 包 括 包 名 、 版 本 号 等 
PackageInfo pi = pm.getPackageArchiveInfo(path, PackageManager.GET_ACTIVITIES); 
if (pi!=nulD) { 
Log.d(TAG, "packageName="+pi.packageName+", version Name="+pi.version Name); 
info.file_path = path; 
info.package_name = pi.packageName; // 包 名 
info.version_name = piversionName; // 版 本 名 称 
info.version_code = pi.versionCode; // 版 本 号 





b 
return info; 打开 APK 文 件 


} 文件 名 称 APK 包 名 。 ”版 本 名 称 
按照 上 面 的 两 个 步骤 , 就 能 获得 每 个 APK 文件 对 应 LayoutPlugin com.yunos.layout.plugin ”2.0 
的 包 名 了 以 及 该 文件 的 版 本 号 o 测试 App 在 真 机 上 运行 DangDang com.dangdang.buy2 8.2.0 
界 面 如 图 10-37 所 示 ? 可 见 当前 设备 已 经 存在 QQ、 京 A ingdong_6.6.4 com.jingdong.app.mall 6.6.4 
当当 的 安装 包 了 。 0 
另外 注意 ，Android 从 8.0 开始 , 要 求 普通 应 用 必须 声 orbonin Ce 
明 安装 其 他 App 的 权限 ,否则 ,将 不 能 像 以 前 那样 为 所 欲 ” [emoAcivy on 
为 随便 安装 别 的 什么 应 用 。 对 于 开发 者 的 App 编码 工作 来 
说 ， 就 是 要 给 应 用 超市 补充 下 面 的 一 行 权限 配置 : 








图 10-37 ”找到 设备 上 已 经 有 的 APK 文件 
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<!-- 安装 应 用 请 求 ，Android8.0 需要 --> 
<uses-permission android:name="android.permission.REQUEST INSTALL PACKAGES" 廊 


10.5.3 ”代码 示例 


(1) 访问 网 络 、 文 件 下 载 以 及 应 用 安装 ， 要 记得 往 AndroidManifest.xml 添加 对 应 的 权限 


配置 : 


<!-- 互联 网 -> 

<uses-permission android:name="android.permission.INTERNET" /> 

<!-- 查看 网 络 状态 -> 

<uses-permission android:name="android.permission.ACCESS NETWORK STATE"/> 
<uses-permission android:name="android.permission.ACCESS_WIFI STATE"/> 

<!--SD 卡 -> 

<uses-permission android:name="android.permission. WRITE EXTERNAL _ STORAGE" /> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE" /> 


<uses-permission android:name="android.permission.MOUNT_UNMOUNT FILESYSTEMS" /> 


<!-- 下 载 时 不 提示 通知 栏 -> 


<uses-permission android:name="android.permission.DOWNLOAD WITHOUT _ NOTIFICATION" /> 


<!-- 安装 应 用 请 求 ，Android 8.0 需要 --> 
<uses-permission android:name="android.permission.REQUEST INSTALL _ PACKAGES" 亡 


(2) 因为 查询 最 新 版 本 号 需要 服务 端 配合 ， 所 以 服务 器 方面 要 提供 一 个 接口 ， 能 够 根据 
应 用 包 名 查询 最 新 版 本 号 ， 以 及 最 新 安装 包 下 载 地 址 。 该 服务 端 程序 参见 本 书 附带 源码 


network_server.rar 压缩 包 中 ，NetServer 工程 里 面 的 CheckUpdate.java。 


(3) 利 用 Gson 库 自动 解析 服务 器 返回 的 检查 结果 JSON 串 , 要 注意 修改 模块 的 build.gradle 
文件 ， 在 里 面 的 dependencies 节点 下 添加 下 面 一 行 配置 ， 表 示 导 入 指定 版 本 的 gson 库 : 


implementation "com.google.code.gson:gson:2.8.2" 


测试 的 时 候 , 不 但 要 在 真 机 上 运行 应 用 超市 App， 也 要 开启 服务 端的 程序 ， 以 便 模拟 应 用 


商店 与 服务 器 之 间 的 通信 过 程 。 首 先 在 服务 器 上 启动 NetServer 工程 ， 用 来 提供 App 


4 更 新 版 


本 号 及 其 下 载 地 址 ;接着 打开 手机 上 的 应 用 超市 页 面 ， 等 待 片刻 界面 就 展开 演示 用 的 App 列 
表 ， 每 个 App 下 方 除了 显示 当前 已 安装 的 版 本 号 ， 还 要 显示 从 服务 器 查询 到 的 最 新 版 本 号 ， 


此 时 应 用 超市 的 初始 界面 如 图 10-38 所 示 。 








注意 到 手机 尚未 安装 美 图 秀 秀 ， 于 是 点 击 它 下 方 的 “下 载 ”按钮 ， 应 用 超市 便 
操作 ， 下 载 时 的 进度 条 界面 〈 包 括 进度 百分比 文字 ) 如 图 10-39 所 示 。 





始 下 载 
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应 用 超市 
爱 奇 艺 酷 狗 音乐 美 图 秀 秀 


当前 版 本 : 8.8.0 


未 安 未 安 
最 新 版 本 : 8.12.5 ”最 新 版 本 : 8.9.2 最 新 版 本 : 7.0.5.0 
下 载 印 载 下 载 


当前 版 本 : 6.5.13 ”当前 版 本 : 7.5.4 当前 版 本 : 7.1.0 
最 新 版 本 : 6.6.1 ”最 新 版 本 : 7.4.0 ”最 新 版 本 : 7.3.2 


印 载 卸载 印 载 














10-38 ”应 用 超市 的 初始 页 面 


继续 等 候 直至 下 载 完成 ， 此 时 按钮 文本 变 为 “安装 ”， 


用 超市 页 面 ， 看 到 美 图 秀 秀 下 方 的 按钮 文字 换 做 了 “ 务 载 ”， 


时 的 应 用 超市 界面 如 图 10-41 所 示 。 


未 安装 当前 版 本 : 8.8.0 下 载 
最 新 版 本 : 8.12.5 ”最 新 版 本 : 8.9.2 最 新 县 本 ; 7.0.5.0 


微 信 QQ 
中 图 有 
当前 版 本 : 6.5.13 ”当前 版 本 : 7.5.4 ”当前 版 本 : 7.1.0 


最 新 版 本 : 6.6.1 ”最 新 版 本 : 7.4.0 ”最 新 版 本 : 7.3.2 
卸载 印 载 








图 1040 应 用 超市 下 载 应 用 完毕 










未 安装 
最 新 版 本 : 8.12.5 
下 载 


当前 版 本 : 6.5.13 
最 新 版 本 : 6.6.1 


图 10-39 


当前 版 本 : 6.5.13 
最 新 版 本 : 6.6.1 


印 载 


10-41 








当前 版 本 : 8.8.0 安装 
最 新 版 本 : 8.9.2 人 7.0.5.0 


" Ez 
固 6 


当前 版 本 : 7.5.4 局 7.1.0 
最 新 版 本 : 7.4.0 ”最 新 版 本 : 7.3.2 





应 用 超市 正在 下 载 应 用 

且 按 钮 背景 色 变 成 绿色 , 如 图 10-40 
所 示 。 上 点击“ 安装 ”按钮 ， 则 调用 系统 的 应 用 安装 程序 ， 一 路 确定 完成 安装 。 te 
表示 该 App 已 经 成 功 安装 ， 





当前 版 本 : 8.8.0 ”当前 版 本 :7.0.5.0 
最 新 版 本 : 8.9.2 最 新 版 本 : 7.0.5.0 


印 载 


QQ 


卸载 

淘宝 
@ 
当前 版 本 : 7.5.4 。 当前 版 本 : 7.1.0 


最 新 版 本 : 7.4.0 。 最 新 版 本 : 7.3.2 
印 载 印 载 





应 用 超市 完成 应 用 更 新 
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本 实战 项 目 用 到 的 网 络 技 术 ， 在 前 面 的 章节 中 都 做 了 详细 说 明 ， 唯 独 应 用 的 安装 与 卸载 
操作 ,迄今 尚未 加 以 介绍 。 其 实 安装 与 卸载 只 管 调用 系统 程序 即 可 ,无 需 开 发 者 另行 手工 编码 
实现 ， 下 面 是 调用 系统 程序 的 安装 和 印 载 代 码 例子 : 


/ 安装 指定 路 径 的 APK 文件 
public static boolean install(Context context String filePath) { 


} 


File file = new File(filePath); 
if (!file.exists() || !file.isFile() || file.length() <= 0) { 

return false; 
} 
/ 根据 指定 文件 创建 一 个 Uri 对象 
Uri uri = Uri.fromFile(file); 
/ 创建 一 个 浏览 动作 的 意图 
Intent intent = new Intent(Intent.ACTION_VIEW); 
/ 设置 Uri 的 数据 类 型 为 APK 文件 
intent.setDataAndType(uri, "application/vnd.android.package-archive"); 
/ 给 意图 添加 开辟 新 任务 的 标志 
intent.addFlags(Intent.FLAG_ ACTIVITY NEW _TASK); 
// 启动 系统 自 带 的 应 用 安装 程序 
context.startActivity(intent); 
return true; 


// 卸载 指定 包 名 的 App 
public static boolean uninstall(Context context, String packageName) { 


} 


if (TextUtils.isEmpty(packageName)) { 

return false; 
} 
/ 根据 指定 包 名 创建 一 个 Uri 对象 
Uri uri = Uri.parse("package:"+packageName); 
/ 创建 一 个 删除 动作 的 意图 
Intent intent = new Intent(Intent.ACTION_DELETE, uri); 
/ 给 意图 添加 开辟 新 任务 的 标志 
intent.addFlags(Intent. FLAG_ ACTIVITY_NEW_TASK); 
/ 启动 系统 自 带 的 应 用 卸载 程序 
context.startActivity(intent); 
return true; 


具体 的 应 用 超市 处 理 代码 限于 篇 幅 就 不 贴 了 , 读者 可 参考 本 书 附带 源码 network 模块 里 的 
AppStoreActivity.java 和 PackageInfoAdapter.java。 其 中 前 者 为 应 用 商店 的 页 面 源码 ， 主 要 完成 
请 求 服务 器 查询 最 新 版 本 号 及 下 载 地 址 的 工作 ; 后 者 是 应 用 列表 的 适配器 ， 主 要 完成 App 的 








下 载 和 下 载 进度 展示 ， 以 及 下 载 完成 后 的 安装 准备 工作 。 
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10.6 “实战 项 目 : 仿 手机 QQ 的 聊天 功能 


说 到 使 用 最 广泛 的 App， 无疑 是 以 手机 QQ、 微 信和 为 代表 的 即时 通信 或 社交 类 App， 类 似 
的 App 还 有 陌 陌 、 旺 旺 等 。 这 些 社交 App 基本 都 是 主打 聊天 功能 ， 聊 天 的 内 容 包括 文本 消息 、 
图 片 消息 、 语 音 消 息 、 视 频 消息 等 ， 其 展现 内 容 之 丰富 、 通 信 手 段 之 多 样 实 为 App 界 的 翘楚 。 
本 节 以 “ 仿 手机 QQ 的 聊天 功能 ”作为 实战 项 目 ， 通 过 剖析 即时 通信 的 相关 技术 使 得 读者 进 一 
步 加 深 对 网 络 通信 开发 的 理解 。 


10.6.1 设计 思路 


手机 QQ 的 聊天 界面 大 家 再 熟悉 不 过 了 。 不 过 作为 App 开发 者 的 你 ， 是 否 能 够 自己 “ 山 
寨 ” 一 个 聊天 App? 听 起 来 很 高 深 的 样子 ， 自 己 只 是 一 个 初学 者 啊 。 有 道 是 世上 无 难事 ， 只 怕 
有 心 人 , 谁 说 初学 者 就 做 不 到 ? 下 面 跟着 笔者 一 步 一 步 往 下 走 ， 慢 慢 抽 丝 剥 草 , 看 看 QQ 内 部 
到 底 藏 着 什么 “葵花 宝典 ”。 

先 来 两 张 手机 QQ 的 界面 截图 。 如 图 10-42 所 示 为 联系 人 频道 的 好 友 列 表 页 面 ; 如 图 10-43 
所 示 为 与 好 友 聊 天 的 主页 面 ， 文 本 消息 、 图 片 消息 、 语 音 消息 都 在 这 里 发 送 与 接收 。 

看 过 了 官方 App 的 界面 ， 再 回来 琢磨 与 本 章 的 网 络 通信 技术 有 什么 关系 。 也 许 读者 初 来 
乍 到 ， 还 不 太 明白 ， 下 面 给 出 一 个 山寨 后 的 效果 图 ， 让 读者 先 有 一 个 直观 的 认识 。 准 备 山寨 的 
效果 页 面 如 图 10-44 和 图 10-45 所 示 。 其 中 ， 图 10-44 是 山寨 后 的 好 友 列 表 页 面 ， 图 10-45 是 
山寨 后 的 聊天 页 面 。 

现在 看 起 来 ， 功 能 相对 纯粹 了 许多 ， 去 掉 了 无 关 的 技术 部 分 ， 只 保留 与 本 章 知 识 点 有 关 
的 内 容 。 
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图 10-42 ”好 友 列表 页 面 图 10-43 ”聊天 窗口 页 面 
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《联系 人 
好 友 列 表 与 轻 舞 飞扬 聊天 
i 大 山 2018-05-27 17:17:17 
© 轻 舞 飞扬 2018-05-27 16:07:46 hi， 好 久 不 见 
经 舞 飞扬 2018-05-27 16:31:16 
多 大 山 2018-05-27 16:54:30 嘲 嘻 ， 是 哈 
大 山 2018-05-27 17:17:53 
亲 威 10 个 好 友 周末 去 哪 玩 了 呀 ? 
轻 舞 飞扬 2018-05-27 16:32:08 
本 人 去 森林 公园 赏 花 了 ， 你 呢 ? 
同学 12 个 好 友 
同事 10 个 好 友 
客户 5 个 好 友 
刷新 
会 [a 呀 发 送 
联系 人 
图 10-44 山寨 后 的 好 友 列表 页 面 图 10-45 山寨 后 的 聊天 窗口 页 面 


下 面 分 析 一 下 效果 图 涉及 的 本 章 的 知识 点 。 控 件 看 得 见 、 摸 得 着 ， 列 举 并 不 困难 ， 而 网 
络 通信 在 后 台 运行 , 不 是 马上 能 够 想得到 、 说 得 出 的 ， 所 以 不 妨 尽 可 能 地 发 挥 想像 力 ,无 论 有 
没有 、 能 不 能 实现 ， 先 列举 出 来 再 说 。 笔 者 这 里 归纳 了 以 下 8 个 重点 。 

e@ 多 线程 : 网 络 通信 必然 使 用 多 线程 技术 。 

e@ HTTP 接口 调用 : App 向 服务 器 请 求全 部 好 友 列 表 ， 是 正规 的 HTTP 接口 访问 。 
HTTP 获取 图 片 : 好 友 的 最 新 头像 ， 因 为 是 小 图 ， 所 以 适合 通过 HTTP 协议 直接 获取 图 
片 。 
文件 上 传 : 发 送 图 片 消息 和 语音 消息 时 都 得 把 手机 上 的 图 片 或 声音 文件 上 传 给 服务 器 。 
文件 下 载 : 对 方 接收 图 片 和 语音 消息 ， 很 可 能 从 服务 器 下 载 图 片 和 声音 文件 到 手机 里 。 
文件 对 话 框 : 选择 上 传 的 文件 和 保存 收 到 的 文件 都 会 用 到 文件 对 话 框 。 
文字 进度 圆圈 : 对 方 接收 图 片 或 语音 时 ， 聊 天 窗口 往往 先 显示 点 位 图 标 ， 再 根据 下 载 进 
度 展 示 圆 弧 形 式 的 百分比 ， 让 用 户 知晓 消息 发 送 与 接收 的 进展 。 

e ”Socket 通信 : 这 个 技术 是 重 中 之 重 ， 因 为 所 有 聊天 消息 都 通过 Socket 通信 传送 给 对 方 。 

接 下 来 对 Socket 通信 进行 补充 说 明 ， 因 为 涉及 客户 端 与 服务 端的 交互 ， 所 以 通信 的 流程 
稍微 有 些 复杂 。 

1. 划分 聊天 场景 的 功能 点 

平常 我 们 看 到 的 QQ 聊天 相关 页 面 有 3 个 : 登录 页 面 、 好 友 列 表 页 面 和 聊天 页 面 。 因 此 ， 
对 应 的 Socket 功能 也 分 为 3 类 : 

(1) 登录 与 注销 。 登 录 操 作对 应 建立 Socket 连接 ， 注 销 操作 对 应 断 开 Socket 连接 。 

(2) 获取 在 线 好 友 列 表 。 与 Socket 有 关 的 是 获取 当前 在 线 的 好 友 列 表 ， 客 户 端 到 服务 端 
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查询 当前 已 建立 Socket 连接 的 好 友 列 表 。 

(3) 发 送 消息 与 接收 消息 。 发 送 与 接收 消息 对 应 的 是 Socket 的 数据 传输 ， 发 送 消息 操作 
是 客户 端 A 向 服务 端 发 送 Socket 数据 , 接收 消息 操作 是 服务 端 将 收 到 的 A 消息 向 客户 端 B 发 
送 Socket 数据 。 


2. 在 App 端 实现 相关 功能 


(1) 至 少 3 个 聊天 相关 页 面 : 登录 页 面 、 好 友 列 表 页 面 和 聊天 页 面 。 

(2) 一 个 用 于 Socket 通信 的 线程 ,由 于 在 App 运行 过 程 中 要 保持 Socket 连接 , 因此 Socket 
线程 要 放 在 自 定义 的 Application 类 中 。 

(3) 聊天 页 面向 Socket 线程 发 送 消 息 的 机 制 ， 用 于 登录 请 求 、 注 销 请 求 、 获 取 在 线 好 友 
列表 请 求 、 发 送 消 息 等 。 

(4) Socket 线程 向 页 面 发 送 消息 的 机 制 ， 用 于 返回 在 线 好 友 列 表 、 接 收 消息 等 。 因 为 返 
回 消息 会 分 发 到 不 同 的 页 面 ， 所 以 建议 采用 广播 Broadcast 传播 消息 ， 在 好 友 列 表 页 面 和 聊天 
页 面 各 注册 一 个 广播 接收 器 ， 根 据 服 务 器 返回 的 数据 刷新 在 线 好 友 列 表 和 聊天 记录 。 
(5) 对 于 图 片 消息 与 声音 消息 的 发 送 。 可 先 把 文件 上 传 到 服务 器 ， 然 后 把 文件 下 载 地 址 
作为 消息 文本 传 给 对 方 ; 对 方 App 收 到 消息 后 ， 根 据 消息 文本 中 的 文件 地 址 把 文件 下 载 到 本 
地 ， 再 在 聊天 页 面 上 展示 出 来 。 


3. 在 服务 端 启动 Socket 服务 器 
启动 Socket 服务 器 后 ， 实 现 以 下 功能 : 


(1) 定义 一 个 Socket 连接 的 队列 ， 用 于 保存 当前 连接 的 Socket 请 求 。 

(2) 循环 侦 听 指定 端口 ， 一 旦 有 新 连接 进来 ， 就 将 该 连接 加 入 Socket 队列 ， 并 启动 新 线 
程 为 该 连接 服务 。 

(3) 每 个 服务 线程 持续 从 Socket 中 读 取 客户 端 发 过 来 的 数据 ， 并 对 不 同 请 求 做 相应 的 处 理 。 


中 如 果 是 登录 请 求 ， 就 标识 该 Socket 连接 的 用 户 昵 称 、 设 备 编号 、 登 录 时 间 等 信息 。 

@ 如 果 是 注销 请 求 ， 就 断 开 Socket 连接 ， 并 从 Socket 队列 中 移 除 该 连接 。 

@ 如 果 是 获取 在 线 好 友 列 表 请 求 ， 就 遍历 Socket 队列 ， 封 装 好 友 列 表 数 据 并 返回 。 

@ 如 果 是 发 送 消息 请 求 ,就 根据 好 友 的 设备 编号 到 Socket 队 列 中 查找 对 应 的 Socket 连接 ， 
并 向 该 连接 返回 消息 内 容 。 

4. 定义 服务 端 与 客户 端 之 间 传 输 消 息 的 格式 

消息 包 分 为 包头 与 包 体 ， 包 头 用 于 标识 操作 类 型 、 操 作对 象 、 操 作 时 间 等 基本 要 素 ， 包 
体 用 于 存放 具体 的 消息 内 容 (如 好 友 列 表 、 消 息 文 本 等 ) 。Socket 通信 一 般 不 用 XML 或 JSON 
等 复杂 格式 ， 而 是 直接 用 分 隔 符 划分 包头 、 包 体 以 及 包头 内 部 的 元 素 。 
10.6.2 ”小 知识 : 可 折 又 列表 视图 ExpandableListView 


可 折 对 列表 视图 是 一 种 多 功能 的 高 级 控件 ， 每 个 子 项 都 可 以 展开 一 个 孙子 列表 。 点 击 一 
个 分 组 〈 子 项 ) ， 即 可 展开 该 分 组 下 的 孙子 列表 ; 再 次 点 击 该 分 组 ， 即 可 收 起 该 分 组 下 的 孙子 
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列表 。 如 果 LinearLayout 是 一 维 视图 ，ListView 与 GridView 是 二 维 视图 ，ExpandableListView 
就 是 三 维 视图 。 可 折 针 列表 视图 虽然 号 称 高 级 , 但 使 用 的 场合 不 少 , 常见 的 业务 场景 包括 好 友 
分 组 与 好 友 列 表 、 邮 件 夹 分 组 与 邮件 列表 、 订 单列 表 与 订单 内 的 商品 列表 等 。 

下 面 是 可 折合 列表 视图 的 常用 方法 说 明 。 


setAdapter: 设置 适配器 。 适 配器 类 型 为 ExpandableListAdapter。 

expandGroup: 展开 指定 分 组 。 

collapseGroup: 收 起 指定 分 组 。 

isGroupExpanded: 判断 指定 分 组 是 否 展开 。 

setSelectedGroup: 设置 选中 的 分 组 。 

setSelectedChild: 设置 选中 的 孙子 项 。 

setGroupIndicator: 设置 指定 分 组 的 指示 图 像 。 

setChildIndicator: 设置 指定 孙子 项 的 指示 图 像 。 

setOnGroupExpandListener: 设置 分 组 展开 监听 器 。 需 实现 接口 OnGroupExpandListener 

的 onGroupExpand 方法 ， 该 方法 在 点 击 展 开 分 组 时 触发 。 

e setOnGroupCollapseListener: 设置 分 组 收 起 监听 器 。 需 实现 接口 OnGroupCollapseListener 
的 onGroupCollapse 方法 ， 该 方法 在 点 击 收 起 分 组 时 触发 。 

esetOnGroupClickListener: 设置 分 组 点 击 监听 器 。 需 实现 接口 OnGroupClickListener 的 
onGroupClick 方法 ， 该 方法 在 点 击 分 组 时 触发 。 

e@ setOnChildClickListener: 设置 孙子 项 点 击 监听 器 。 需 实现 接口 OnChildClickListener 的 

onChildClick 方法 ， 该 方法 在 点 击 孙 子 项 时 触发 。 


可 折 登 列表 视图 拥有 专属 的 适配器 可 折 又 列表 适配器 ExpandableListAdapter。 下 面 是 
该 适配器 经 常 要 重 写 的 5 个 方法 。 
getGroupCount: 获取 分 组 的 个 数 。 
getChildrenCount: 获取 孙子 项 的 个 数 。 
getGroupView: 获取 指定 分 组 的 视图 。 
getChildView: 获取 指定 孙子 项 的 视图 。 
isChildSelectable: 判断 孙子 项 是 否 允 许 选 择 。 


下 面 演 示 如 何 使 用 可 折 鳃 列表 视图 实现 电子 邮箱 的 管理 功能 。 首 先 编写 邮箱 列表 的 适 配 
详细 代码 如 下 (为 节省 篇 幅 ， 省 略 了 没有 实际 内 容 的 重 写 方法 ): 
public class MailExpandA dapter implements ExpandableListAdapter OnGroupClickListener, 
OnChildClickListener { 

private Context mContext; // 声明 一 个 上 下 文 对 象 

private ArrayList<MailBox> mBoxList; // 邮箱 队列 








器 


public MailExpandA dapter(Context context ArrayList<MailBox> box_lisb { 
mContext = context; 
mBoxList = box_list; 
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// 获取 分 组 的 数目 
public int getGroupCountO { 
return mBoxList.size(); 


/ 获取 某 个 分 组 的 孙子 项 数目 
public int getChildrenCount(int groupPosition) { 
return mBoxList.get(groupPosition).mail list.size(); 


/ 获取 指定 位 置 的 分 组 
public Object getGroup(int groupPosition) { 
return mBoxList.get(groupPosition); 


// 根据 分 组 位 置 ， 以 及 孙子 项 的 位 置 ， 获 取 对 应 的 孙子 项 
public Object getChild(int groupPosition, int childPosition) { 
return mBoxList.get(groupPosition).mail_list.get(childPosition); 


/ 获取 分 组 的 编号 
public long getGroupId(int groupPosition) { 
return groupPosition; 


/ 根据 分 组 位 置 ， 以 及 孙子 项 的 位 置 ， 获 取 对 应 的 孙子 项 编号 
public long getChildId(int groupPosition, int childPosition) { 
return childPosition; 


// 获取 指定 分 组 的 视图 
public View getGroupView(int groupPosition, boolean isExpanded, 
View convertView, ViewGroup parent) { 
ViewHolderBox holder: 
if (convertView 一 nulD) { 
holder = new ViewHolderBox(); 
convertView = LayoutInflater.from(mContext).inflate(R.layout.item_box, null); 
holderiv_box = convertView.findViewById(R.id.iv_box); 
holdertv_box = convertView.findViewById(R.id.tv_box); 
holdertv_count = convertView.findViewById(R.id.tv_count); 
convertView.setTag(holder); 
}else{ 
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holder = (ViewHolderBox) convertView.getTag(); 
} 
MailBox box = mBoxList.get(groupPosition); 
holder.iv_box.setImageResource(box.box_icon); 
holder.tv_box.setText(box.box_title); 
holder.tvy_count.setText(box.mail_list.size() +" 封 邮件 "); 
return convertView; 


// 获取 指定 孙子 项 的 视图 
public View getChildView(final int groupPosition, final int childPosition, 
boolean isLastChild, View convertView, ViewGroup parent) { 
ViewHolderMail holder:; 
if (convertView 一 nulD) { 
holder = new ViewHolderMail(); 
convertView = LayoutInflater.from(mContext).inflate(R.layout.item_mail, null); 
holder.ck_mail = convertView.findViewById(R.id.ck_mail); 
holdertv_date = convertView.findViewById(R.id.tv_date); 
convertView.setTag(holder); 
} else { 
holder = (ViewHolderMail) convertView.getTag(); 
b 
Mailltem item = mBoxList.get(groupPosition).mail list.get(childPosition); 
holder.ck_mail.setFocusable(false); 
holder.ck_mail.setFocusableInTouchMode(false); 
holder.ck_mail.setText(item.mail_title); 
holder.ck_mail.setOnCheckedChangeListener(new OnCheckedChangeL istener() { 
@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
MailBox box = mBoxList.get(groupPosition); 
Mailltem item = box.mail_list.get(childPosition); 
String desc = String.format(" 您 点 击 了 %s 的 邮件 ， 标 题 是 %s", box.box_title, 
item.mail_title); 
Toast.makeText(mContext, desc, Toast. LENGTH_SHORT).show(); 


D); 
holder.tv_date.setText(item.mail_date); 


return convertView:; 


// 判断 孙子 项 是 否 允许 选择 。 如 果子 条 目 需 要 响应 点 击 事件 ， 这 里 要 返回 tue 
public boolean isChildSelectable(int groupPosition, int childPosition) { 
return true; 
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} 


然后 在 页 面 代码 中 给 可 折 且 列表 视图 设置 对 应 的 适配器 对 象 ， 具 体 的 代码 片段 如 下 : 


) 


// 定义 一 个 邮箱 分 组 的 视图 持 有 者 
public final class ViewHolderBox { 
public ImageView iv_box; 
public TextView tv_box; 
public TextView tv_count; 


// 定义 一 个 邮件 条 目的 视图 持 有 者 

public final class ViewHolderMail { 
public CheckBox ck_mail; 
public TextView tv_date; 

}; 


// 在 孙子 项 被 点 击 时 触发 
public boolean onChildClick(ExpandableListView parent, View v, 
int groupPosition, int childPosition, long id) { 
ViewHolderMail holder = (ViewHolderMail) v.getTag(); 
holder.ck_mail.setChecked(!(holder.ck_mail.isChecked())); 
return true; 


} 


/ 在 分 组 标题 被 点 击 时 触发 。 如 果 返 回 true， 就 不 会 展示 子 列表 
public boolean onGroupClick(ExpandableListView parent, View v, 
int groupPosition, long id) { 
String desc = String.format(" 您 点 击 了 %s", mBoxList.get(groupPosition).box_title); 
Toast.makeText(mContext, desc, Toast. LENGTH_SHORT).show(); 
return false; 


// 初始 化 整个 邮箱 

private void initMailBox() { 
// 从 布局 文件 中 获取 名 叫 elv_list 的 可 折 释 列表 视图 
ExpandableListView elv_list = findViewById(R.id.elv_list); 
// 以 下 依次 往 邮 箱 队列 中 添加 收 件 箱 、 发 件 箱 、 草 稿 箱 、 废 件 箱 的 列表 信息 
ArrayList<MailBox> box_list = new ArrayList<MailBox>(); 
box_list.add(new MailBox(R.drawable.mail_ folder_inbox, " 收 件 箱 ", getRecvMailO)); 
box_list.add(new MailBox(R.drawable.mail_ folder_outbox, "发 件 箱 ", getSentMail())); 
box_list.add(new MailBox(R.drawable.mail folder_draft, "草稿 箱 ", getDraftMail())); 
box_list.add(new MailBox(R.drawable.mail folder recycle, " 废 件 箱 ", getRecycleMail0)); 
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/ 构建 一 个 邮箱 队列 的 可 折 欠 列表 适配器 


MailExpandA dapter adapter = new MailExpandAdapter(this, box_list); 


/ 给 elv_list 设置 邮箱 可 折 又 列表 适配器 


elv_list.setAdapter(adapter); 


/ 给 elv_list 设置 孙子 项 的 点 击 监听 器 
elv_list.setOnChildClickListener(adapter); 
// 给 elv_list 设置 分 组 的 点 击 监听 器 
elv_list.setOnGroupClickListener(adapter); 
/ 默认 展开 第 一 个 邮件 夹 ， 即 收 件 箱 


elv_list.expandGroup(0); 


’ 


电子 邮箱 的 展示 效果 如 图 10-46 和 图 10-47 所 示 。 其 中 ， 如 图 10-46 所 示 为 展开 收 件 箱 时 


的 初始 界面 ， 图 10-47 所 示 为 点 


00 邮 箱 
站 收 件 条 
已 了 这 里 是 收 件 箱 呆 1 
这 里 是 收 件 条 本 2 
[这 里 是 收 件 箱 吁 3 
[这 里 是 收 件 箱 喇 4 
太一 这 里 是 收 件 箱 呀 5 
了 发 件 箱 


国 草稿 箱 








从 刻 件 箱 


图 10-46 展开 收 件 箱 时 的 初始 界面 





5 封 闻 件 
2018 年 5 月 15 日 
2018 年 5 月 10 日 
2018 年 5 月 14 日 
2018 年 5 月 11 日 
2018 年 5 月 13 日 

5 封 邮件 

5 封 邮件 


5 封 郎 件 





fi 收 起 收 件 箱 后 ， 点 击 展开 发 件 箱 时 的 界面 。 


network 
00 邮 箱 
站 收 件 箱 5 封 闻 件 


坷 发 件 箱 5 封 邮 件 


[邮件 发 出去 了 吗 1 2018 年 5 月 15 日 


站 sp 发 册 去 7 吗 2 2018 年 5 月 14 日 


站 age 发 册 去 7 吧 3 2018 年 5 月 1 日 
站 si 册 去 7 吗 4 2018 年 5 月 13 晶 
EJ ae 发 册 去 7 吗 5 2018 年 5 月 10 日 

目 草 杭 条 5 封 郎 件 


商 话 作 条 5 封 郎 件 





图 10-47 点 击 展 开发 件 箱 时 的 界面 


可 折合 列表 视图 有 时 会 出 现 孙 子 项 不 响应 点 击 事件 的 问题 ， 可 能 是 某 个 环节 没有 正确 设 
置 。 要 让 孙子 项 正常 响应 点 击 事件 ， 需 满足 下 面 3 个 条 件 : 

(1) 可 折 倒 列表 适配器 的 isChildSelectable 方法 要 返回 true。 

(2) 可 折合 列表 视图 的 对 象 要 调用 setOnChildClickListener 方法 注册 孙子 项 的 点 击 监听 


器 ， 并 重 写 该 监听 器 的 onChildClick 方法 。 








即 调用 这 些 控 件 的 setFocusable 和 setFocusableInTouchMode 方法 ， 并 设置 为 false。 也 可 参照 
第 5 章 “5.2.2 列表 视图 ListView” 中 处 理子 项 抢占 焦点 的 做 法 ， 给 列表 项 布局 文件 的 根 节点 
加 上 descendantFocusability 属性 ， 声 明 在 列表 项 范围 内 剥夺 下 级 控件 的 抢占 权利 ， 代 码 如 下 : 


android:descendantFocusability="blocksDescendants" 


10.6.3 ”代码 示例 


编码 方面 需要 注意 以 下 两 点 : 
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(1) 访问 网 络 、 文 件 上 传 与 下 载 时 ， 要 在 AndroidManifest.xml 添加 对 应 的 权限 配置 : 


<!-- 互联 网 -> 

<uses-permission android:name="android.permission.INTERNET" /> 

<!-- 查看 网 络 状态 -> 

<uses-permission android:name="android.permission.ACCESS_ NETWORK _ STATE" /> 
<uses-permission android:name="android.permission.ACCESS_WIFI STATE" /> 

<!-SD 卡 -> 

<uses-permission android:name="android.permission. WRITE EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.MOUNT_ UNMOUNT FILESYSTEMS"/> 
<!-- 下 载 时 不 提示 通知 栏 -> 

<uses-permission android:name="android.permission.DOWNLOAD WITHOUT_ NOTIFICATION" /> 


(2) AndroidManifest.xml 的 application 节点 注意 补充 android:name=".MainApplication"。 
另外 ， 要 注册 在 线 好 友 列 表 获取 和 消息 接收 的 广播 接收 器 ， 注 册 代 码 如 下 : 

<!- 接收 Socket 得 到 的 收 到 对 方 消息 事件 --> 

<receiver android:name=".ChatMainActivity$SRecvMsgReceiver" > 
<intent-filter> 

<action android:name="com.example.network.RECV_MSG" /> 

</intent-filter> 

</receiver> 

<!- 接收 Socket 得 到 的 获取 好 友 列 表 事件 --> 

<receiver android:name=".QQContactActivitySGetListReceiver" > 
<intent-filter> 


<action android:name="com.example.network.GET_LIST" 亡 
</intent-filter> 
</receiver> 


因为 网 络 通信 需要 服务 端 配合 ， 所 以 服务 器 方面 需要 实现 3 个 后 台 功 能 。 
(1) 文件 上 传 功能 ， 源 码 参 见 本 书 附带 源码 NetServer 工程 里 的 UploadServlet.java。 


(2) 获取 好 友 列 表 接 口 ， 源 码 参见 本 书 附带 源码 NetServer 工程 里 的 QueryFriend.java。 
(3) Socket 服 务 器 ， 源 码 参见 本 书 附带 源码 SocketServer 工 程 中 的 ChatServerjava。 


实战 项 目 不 但 要 在 真 机 上 测试 ， 而 且 要 开启 服务 端 程序 ， 这 样 才能 真 刀 真 枪 地 模拟 即时 
通信 的 真实 场景 。 首 先 在 服务 器 上 分 别 启动 NetServer 工程 











和 SocketServer 工程 , 然后 准备 两 台 手 机 分 别 安装 实战 项 目 
编译 后 的 App 《注意 ， App 代码 中 的 URL 服务 地 址 必须 是 | 
正确 的 服务 器 IP， 并 且 手 机 与 服务 器 在 同一 个 网 段 ) ， 接 登 录 





着 两 台 手机 都 运行 实战 项 目的 聊天 App, 在 如 图 10-48 所 示 

的 登录 页 面 输入 昵称 ， 点 击 登录 按钮 ， 进 入 好 友 列 表 页 面 。 1048 实战 项 目的 登录 页 面 
好 友 列 表 的 页 面 效 果 如 图 10-49 和 图 10-50 所 示 。 其 中 ， 如 图 10-49 所 示 为 展开 在 线 好 友 

分 组 时 的 好 友 列表 界面 ， 可 以 看 到 手机 A 的 登录 昵称 是 “ 轻 舞 飞扬 ”， 手 机 B 的 登录 昵称 是 
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“大 山 ”; 如 图 10-50 所 示 为 展开 亲戚 分 组 时 的 好 友 列 表 界 面 。 














2 个 好 友 
7 个 好 友 
5 个 好 友 
9 个 好 友 
图 10-49 ”展开 在 线 好 友 分 组 时 的 界面 图 10-50 ”展开 亲戚 分 组 时 的 列表 界面 
两 台 手 机 都 点 击 对 方 昵称 ， 进 入 聊天 主页 面 ， 页 面 下 方 有 文本 编辑 框 ， 可 发 送 文 本 消息 。 


左下 角 有 图 片 的 图 标 按钮 ,点击 即 可 选择 图 片 并 发 送 图 片 消息 ; 图 片 按钮 右边 是 声音 的 图 标 按 
钮 ， 点击 即 可 选择 音频 文件 并 发 送 声音 消息 。 为 了 看 起 来 更 逼真 ， 消 息 窗口 采用 对 方 消息 靠 左 
对 齐 、 我 方 消息 靠 右 对 齐 的 布局 ， 并 给 双方 消息 着 不 同 的 背景 色 。 对 于 文本 消息 来 说 ， 双 方 消 
息 窗口 直接 展示 文字 内 容 就 可 以 了 ; 对 于 图 片 消息 来 说 , 消息 窗口 应 展示 图 片 的 缩 略图 ， 用 户 
点 击 缩 略 图 后 ,再 展示 图 片 的 大 图 ; 对 于 声音 消息 来 说 ,消息 窗口 只 展示 声音 图 标 ,一 旦 用 户 
点 击 声音 图 标 ， 系 统 就 开始 播放 对 应 的 声音 文件 。 

具体 测试 的 聊天 效果 如 图 10-51 一 图 10-54 所 示 。 其 中 , 图 10-51 和 图 10-52 所 示 为 手机 A 
(了 昵称“ 轻 舞 飞扬 ”) 的 聊天 窗口 ， 图 10-53 和 图 10-54 所 示 为 手机 B (昵称 “大 山 ”) 的 聊 
天 窗口 。 


与 大 山 聊 天 与 大 山 巴 天 


大 山 2018.05.27 17.56:45 


大 山 2018.05.27 1805.47 
hi 好 久 不 见 全 ,好久 不 见 


径 兰 飞扬 201805.27 17.56.53 反 则 飞扬 2018.0527 1805.54 
机 大 ,是 的 呈 过 ,是 的 呵 

大 山 2018.0527 17:5727 

出 未 天 去 公司 了 , 好 多 昱 花 ， 你 呢 7 

Ki 2018.052717:57.44 

Bl 

J ? 


大 山 2018.05.27 18:06:19 
两 未 我 去 公园 了 , 好 多 鲜花 你 呢 ? 


W2018.05.27 18:0631 


径 本 飞扬 2018.05.27 18.07.04 
周末 我 去 K 欧 了 , 我 给 你 唱 一 段 哈 


轻 其 飞扬 20180527 18.07.19 











图 10-51 与 大 山 的 聊天 窗口 截图 1 图 10-52 与 大 山 的 聊天 窗口 截图 2 
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network 
与 轻 舞 飞扬 那天 
大 山 2018-05-27 18:42:54 
hi, 好 久 不 见 
轻 舞 飞扬 2018-05-27 17:56:54 
嘻 嘻 ， 是 的 呀 


大 山 2018-05-27 18:43:37 
周末 我 去 公园 了 ， 好 多 鲜花 ， 你 呢 ? 


大 山 2018-05-27 18:43:52 
4 Te 


/SK 


与 轻 舞 飞扬 著 天 
大 山 2018-05-27 18:52:28 
周末 我 去 公园 了 ， 好 多 鲜花 ， 你 呢 ? 
大 山 2018-05-27 18:52:38 

和 


Mhf 





和 经 兽 飞扬 2018-05-27 18:07:05 
周 未 我 去 K 歌 了 ， 我 给 你 唱 一 段 哈 


经 舞 飞扬 2018-05-27 18:07:20 


> 


236 秒 
大 山 2018-05-27 18:54:29 
好 笋 ， 唱 得 真 好 听 
I 呈 发 送 








图 10-53 与 轻 舞 飞扬 的 聊天 窗口 截图 1 图 10-54 ”与 轻 舞 飞扬 的 聊天 窗口 截图 2 


至 此 , 实战 项 目 仿照 手机 QQ 基本 实现 了 聊天 功能 的 常用 操作 , 包括 实时 刷新 在 线 好 友 列 
表 、 发 送 与 接收 文本 消息 、 发 送 与 接收 图 片 消息 、 发 送 与 接收 声音 消息 等 。 当 然 ， 本 项 目 尚 有 
若干 待 完 善 的 地 方 ， 有 兴趣 的 读者 可 自行 补充 修改 ， 完 善 点 主要 有 以 下 3 点 : 


(1) 发 送 图 片 与 声音 时 ， 目 前 采用 文件 对 话 框 选择 具体 文件 。 其 实 可 参照 第 9 章 的 设备 
操作 ， 现 场 拍照 或 现场 录音 后 ， 把 照片 和 录音 文件 直接 传 给 对 方 。 另 外 ， 可 增加 对 视频 消息 的 
发 送 与 接收 处 理 。 

(2) 目前 聊天 消息 没有 保存 到 本 地 数据 库 ， 因 此 下 次 打开 对 方 的 聊天 窗口 无 法 查看 之 前 
的 聊天 记录 。 可 参照 第 4 章 的 SQLite 数据 库 操作 把 聊天 消息 保存 到 SQLite 中 , 这 样 每 次 打开 
聊天 窗口 时 都 会 到 数据 库 中 查找 并 显示 历史 聊天 记录 。 

(3) 把 第 9 章 的 实战 项 目 “ 仿 微 信 的 发 现 功 能 ”集成 到 本 章 的 实战 项 目 中 ， 增 强 这 个 聊 
天 App 的 实用 性 和 趣味 性 。 


还 等 什么 呢 ? 快 快 行动 起 来 ， 打 造 一 个 专属 的 即时 通信 App 吧 ! 
下 面 简单 介绍 一 下 本 书 附 带 源码 network 模块 中 , 与 QQ 聊天 有 关 的 主要 代码 之 间 的 关系 : 


(1) MainApplication.java: 这 是 聊天 App 的 主 应 用 入 口 ， 里 面 创建 并 启动 了 一 个 聊天 线 
程 , 之 所 以 把 聊天 任务 做 成 全 局 对 象 ， 是 因为 方便 接收 对 方 的 聊天 消息 ， 即 使 用 户 当前 没 开 着 
聊天 窗口 ，App 也 能 实时 接收 服务 器 传 来 的 消息 内 容 。 

(2) QQContactActivity.java: 这 是 好 友 列 表 页 面 ， 不 但 包括 所 有 好 友 分 组 ， 还 包括 在 线 
好 友 列 表 。 其 中 所 有 好 友 分 组 来 自 HTTP 服务 器 ， 在 线 好 友 列 表 来 自 Socket 服务 器 。 

(3) ChatMainActivity.java: 这 是 与 某 个 好 友 聊 天 的 主 窗口 页 面 ,在 此 可 发 送 /接收 文本 消 
息 、 图 片 消息 、 音 频 消息 。 其 中 文本 类 的 消息 内 容 通 过 Socket 服务 器 传输 ， 图 片 、 音 频 等 多 
媒体 文件 通过 HTTP 服务 器 上 传 和 下 载 。 


另外 补充 Socket 服务 器 与 聊天 功能 有 关 的 代码 逻辑 ， 服 务 端的 SocketServer 工程 主要 涉 
及 到 ChatServer.java 和 ServerThread.java， 简 要 说 明 如 下 : 
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(1) ChatServer.java: 这 是 主 程序 代码 ， 入 口 是 main 函数 。ChatServer 启动 后 ， 会 持续 
侦 听 端口 52000， 一 旦 有 客户 端 连接 进来 ， 就 启动 一 个 服务 线程 为 它 服务 ， 再 给 它 分 配 一 个 
Socket 并 加 入 队列 。 如 果 有 两 部 手机 连接 进来 ， 就 启动 两 个 服务 线程 ，Socket 队列 大 小 为 2。 

(2) ServerThread.java: 这 是 服务 端的 线程 管理 工具 。 它 启动 后 运行 run 函数 ， 从 客户 端 
接收 消息 ， 收 到 回 车 符 就 认为 本 次 消息 接收 完毕 ， 然 后 开始 解析 该 消息 的 内 容 。 


10.7 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 网 络 通信 相关 技术 ， 包 括 多 线程 的 工作 机 制 和 用 法 〈 消 
息 传 递 、 进 度 对 话 框 、 异 步 任 务 、 异 步 服 务 ) 、HTTP 接口 访问 的 方式 〈 网 络 连接 检查 、JSON 
移动 数据 格式 、HTTP 接口 调用 、HTTP 图 片 获 取 ) 、 文 件 上 传 和 下 载 的 实现 与 用 法 〈 下 载 管 
理 器 、 文 件 对 话 框 、 文 件 上 传 》、 套 接 字 的 应 用 《网络 地 址 、Socket 通信 ) 。 最 后 设计 了 两 个 
实战 项 目 , 一 个 是 “ 仿 应 用 宝 的 应 用 更 新 功能 ”, 另 一 个 是 “ 仿 手 机 QQ 的 聊天 功能 ”。 在 “ 仿 
应 用 宝 的 应 用 更 新 功能 ”的 项 目 编码 中 , 采用 了 本 章 介绍 的 部 分 网 络 通信 知识 , 实现 了 应 用 在 
线 更 新 的 完整 流程 。 在 “ 仿 手 机 QQ 的 聊天 功能 ”的 项 目 编码 中 ,详细 阐述 了 即时 通信 技术 的 
原理 与 设计 思路 ,结合 本 章 介绍 的 所 有 网 络 通 信 知识 ， 实 现 了 文本 消息 、 图 片 消息 、 声 音 消息 
的 发 送 与 接收 。 另 外 ， 介 绍 了 如 何 使 用 可 折 车 列表 视图 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 

(1) 学 会 在 合适 的 场合 使 用 多 线程 技术 。 

(2) 学 会 HTTP 方式 的 接口 调用 与 图 片 获取 。 

(3) 学 会 管理 文件 上 传 和 下 载 操作 。 

(4) 学 会 运用 Socket 通信 技术 进行 聊天 应 用 的 开发 。 


本 章 介绍 App 开发 常见 的 一 些 事件 处 理 技术 ， 主 要 包括 如 何 检测 并 接管 按键 事件 ， 如 何 
对 触摸 事件 进行 分 发 、 拦 截 与 处 理 , 如 何 实现 手势 检测 与 飞 掠 视图 的 联合 运用 ,如 何 正确 避免 
手势 冲突 的 意外 状况 。 最 后 结合 本 章 所 学 的 知识 分 别 演示 了 两 个 实战 项 目 “ 抠 图 神器 一 美 图 
变 变 ” 和 “虚拟 现实 的 全 景 图 库 ” 的 设计 与 实现 。 


11.1 按键 事件 


本 节 介绍 App 开发 对 按键 事件 的 检测 与 处 理 ， 首 先 说 明 如 何 检测 控件 对 象 的 按键 事件 ; 
然后 说 明 如 何 检测 活动 页 面 的 物理 按键 ， 并 以 返回 键 为 例 阔 述 “再 按 一 次 返回 键 退出 ”的 功能 
实现 ， 最 后 以 音量 调节 对 话 框 为 例 ， 介 绍 如 何 接管 音量 按键 的 处 理 。 


11.1.1 ”检测 软 键盘 


- 般 不 对 手机 上 的 输入 按键 进行 处 理 ， 直 接 由 系统 按照 默认 情况 操作 。 当 然 有 时 为 了 改 
善 用 户 体验 ， 需 要 让 App 拦截 按键 事件 ， 并 进行 额外 处 理 。 在 第 3 章 介 绍 编辑 框 EditText 的 
用 法 时 提 到 监控 输入 字符 中 的 回 车 键 , 一 旦 发 现 用 户 敲 了 回 车 键 , 就 将 焦点 自动 移 到 下 一 个 控 
件 ， 而 不 是 在 编辑 框 输入 回 车 换行 。 当 时 的 字符 输入 拦截 采用 注册 文本 观测 器 TextWatcher 实 
现 ， 但 该 监听 器 只 适用 于 编辑 框 控件 ， 无 法 用 于 其 他 控件 。 因 此 ， 若 想 让 其 他 控件 能 够 监听 按 
键 操作 ， 则 要 另外 调用 控件 对 象 的 setOnKeyListener 方法 设置 按键 监听 器 ， 并 实现 监听 器 接口 
OnKeyListener 的 onKey 方法 。 

要 监控 按键 事件 ， 首 先 得 知道 每 个 按键 的 编码 ， 这 样 才能 根据 不 同 的 编码 值 进行 相应 的 
处 理 。 按 键 编码 的 取 值 说 明 见 表 11-1。 这 里 注意 ， 监 听 器 OnKeyListener 只 会 检测 控制 键 ， 不 
会 检测 文本 键 〈 字 母 、 数 字 、 标 点 等 ) 。 
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表 11-1 按键 编码 的 取 值 说 明 
































按键 编码 KeyEvent 类 的 按键 名 称 说 明 

3 KEYCODE HOME 主页 键 (未 开放 给 普通 App) 
4 KEYCODE BACK 返回 键 (后退 键 ) 

24 KEYCODE VOLUME UP 加 大 音量 键 

25 KEYCODE VOLUME DOWN 减 小 音量 键 

26 KEYCODE POWER 电源 键 (未 开放 给 普通 App) 
66 KEYCODE ENTER 回 车 键 

67 KEYCODE DEL 删除 键 ( 退 格 键 ) 

82 KEYCODE MENU 菜单 键 

84 KEYCODE SEARCH 搜索 键 

187 KEYCODE APP_ SWITCH 任务 键 〈 未 开放 给 普通 App) 








实际 监控 结果 显示 , 每 次 按 控 制 键 时 ，onKey 方法 都 会 收 到 两 次 重复 编码 的 按键 事件 ， 这 
是 因为 该 方法 把 每 次 按键 都 分 成 按 下 与 松 开 两 个 动作 , 所 以 一 次 按键 变 成 了 两 个 按键 动作 。 解 
决 这 个 问题 的 办 法 很 简单 ， 就 是 只 监控 按 下 动作 (KeyEvent.ACTION_DOWN) 的 按键 事件 ， 
不 监控 松 开动 作 (KeyEvent.ACTION_UP) 的 按键 事件 。 

下 面 是 使 用 软 键盘 监听 器 的 代码 : 


public class KeySoftActivity extends AppCompatActivity implements OnKeyListener { 
private TextView tv_result; 
private String desc = ""; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_key_soft); 
/ 从 布局 文件 中 获取 名 叫 et_soft 的 编辑 框 
EditText et_soft = findViewById(R.id.et_soft); 
/ 设置 编辑 框 的 按键 监听 器 
et_soft.setOnKeyListener(this); 
tv_result = findViewById(R.id.tv_result); 

) 


// 在 发 生 按键 动作 时 触发 
public boolean onKey(View v, int keyCode, KeyEvent event) { 
if (event.getAction() 一 KeyEventACTION_ DOWN) { 
desc = String.format("%s 输入 的 软 按键 编码 是 %d, 动 作 是 按 下 ", desc, keyCode); 
if (keyCode — KeyEvent KEYCODE ENTER) { 
desc = String.format("%s， 按 键 为 回 车 键 ", desc); 
} else if (keyCode — KeyEvent KEYCODE DEL) { 
desc = String.format("%s， 按 键 为 删除 键 ", desc); 
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} else if (keyCode — KeyEvent KEYCODE SEARCH) { 
desc = String.format("%s， 按 键 为 搜索 键 ", desc); 
} else if (keyCode — KeyEvent.KEYCODE BACK){ 
desc = String.format("%s， 按 键 为 返回 键 ", desc); 
/ 延迟 3 秒 后 启动 页 面 关闭 任务 
new Handler().postDelayed(mFinish, 3000); 
} else if (keyCode — KeyEvent. KEYCODE MENU) { 
desc = String.format("%s， 按 键 为 菜单 键 ", desc); 
} else if (keyCode =— KeyEvent.KEYCODE VOLUME UP){ 
desc = String.format("%s， 按 键 为 加 大 音量 键 ", desc); 
} else if (keyCode =— KeyEvent. KEYCODE VOLUME DOWN) { 
desc = String.format("%s， 按 键 为 减 小 音量 键 ", desc); 
} 
desc= desc + "\n"; 
tv_result.setText(desc); 
return true; 
}else{ 
// 返回 tme 表示 处 理 完 了 不 再 输入 该 字符 ， 返 回 false 表示 给 你 输入 该 字符 吧 
return false; 


} 


/ 定义 一 个 页 面 关闭 任务 
private Runnable mFinish = new Runnable() { 
(QOverride 
public void run() { 
finish(); / 关闭 当前 页 面 
} 


} 
上 述 代码 的 按键 效果 如 图 11-1 所 示 。 虽 然 按 键 编码 表 存 在 首页 键 、 任 务 键 、 电 源 键 的 定 
义 ， 但 这 3 个 键 并 不 开放 给 普通 App， 普 通 App 也 不 应 该 拦截 这 些 按键 事件 。 





hello 


输入 的 软 按键 编码 是 66 ,动作 是 按 下 , 按键 为 回 车 键 
输入 的 软 按键 编码 是 67, 动 作 是 按 下 , 技 键 为 删除 键 
输入 的 软 按键 编码 是 24, 动 作 是 按 下 , 按键 为 加 大 音量 键 
输入 的 软 按键 编码 是 25, 动 作 是 按 下 , 按键 为 减 小 音量 键 
输入 的 软 按键 编码 是 82, 动 作 是 按 下 , 按键 为 菜单 键 
输入 的 软 按键 编码 是 4, 动 作 是 按 下 , 按键 为 返回 键 


图 11-1 软 键盘 的 检测 结果 
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11.1.2 ”检测 物理 按键 


除了 给 控件 注册 按键 监听 器 外 ， 还 可 以 直接 在 活动 页 面 上 检测 物理 按键 ， 即 重 写 Activity 
的 onKeyDown 方法 。onKeyDown 方法 的 使 用 与 前 面 的 onKey 方法 类 似 ， 拥 有 按键 编码 与 按 
键 事件 KeyEvent 两 个 参数 ， 当 然 这 两 个 方法 也 存在 不 同 之 处 ， 具 体 说 明 如 下 : 


(1) onKeyDown 只 能 在 Activity 代码 中 使 用 ， 而 onKey 只 要 有 可 注册 的 控件 就 能 使 用 。 

(2) onKeyDown 只 能 检测 物理 按键 ， 无 法 检测 输入 法 按键 〈 如 回 车 键 、 删 除 键 等 ) ， 而 
onKey 可 同时 检测 两 类 按键 。 

(3) onKeyDown 不 区 分 按 下 与 松 开 两 个 动作 ， 而 onKey 区 分 这 两 个 动作 。 


下 面 是 启用 物理 按键 监听 的 代码 片段 : 


// 在 发 生物 理 按键 动作 时 触发 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
desc = String.format("%s 物理 按键 的 编码 是 %d", desc, keyCode); 
if (keyCode =— KeyEvent. KEYCODE BACK){ 
desc = String.format("%s, 按键 为 返回 键 ", desc); 
// 延迟 3 秒 后 启动 页 面 关闭 任务 
new Handler().postDelayed(mFinish, 3000); 
} else if (keyCode 一 KeyEvenLKEYCODE MENU){ 
desc = String.format("%s， 按键 为 菜单 键 ", desc); 
} else if (keyCode — KeyEvent. KEYCODE VOLUME UP){ 
desc = String.format("%s, 按键 为 加 大 音量 键 ", desc); 
} else if (keyCode — KeyEvent. KEYCODE VOLUME DOWN){ 
desc = String.format("%s, 按键 为 减 小 音量 键 ", desc); 








| 

desc = desc + "\n"; 

tv_result.setText(desc); 

/ 返回 true 表示 不 再 响应 系统 动作 ， 返 回 false 表示 继续 响应 系统 动作 
Teturn true; 


// 定义 一 个 页 面 关 闭 任务 


private Runnable mFinish = new Runnable() { 





@Override 
public void run0O) { 
finish(); / 关闭 当前 页 面 
9 请 按 设备 上 的 物理 键 开始 检测 
$B 物理 按键 的 编码 是 24, 按键 为 加 大 音量 键 


物理 按键 的 编码 是 25, 按键 为 减 小 音量 键 


键 的 监听 效果 如 图 11-2 所 示 。 太 前 的 “| 物理 按键 的 编码 是 82, 按键 为 菜单 键 
物理 按键 的 监听 效果 如 图 11-2 所 示 。 对 于 目前 的 Wr 
App 开发 来 说 ,onKeyDown 方法 只 可 检测 4 个 物理 按键 、|12:14:04 按键 为 主页 刍 


事件 ， 即 菜单 键 、 返 回 键 、 加 大 音量 键 和 减 小 音量 键 ， 图 11-2 物理 按键 的 检测 结果 
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而 主页 键 和 任务 键 需要 通过 广播 接收 器 来 监测 。 
检测 物理 按键 最 常见 的 应 用 是 淘宝 主页 的 “再 按 一 次 返回 键 退出 ”， 在 App 首页 按 返 回 
键 ， 系 统 默 认 的 做 法 是 直接 退出 该 App。 然 而 用 户 有 可 能 不 小 心 按 了 返回 键 ， 并 非 想 退 出 该 
App， 因 此 这 里 加 一 个 小 提示 ， 等 待 用 户 再 次 按 返 回 键 才 会 确认 退出 意图 ， 并 执行 退出 操作 。 
“再 按 一 次 返回 键 退出 ”的 实现 代码 很 简单 ， 在 onKeyDown 方法 中 拦截 返回 键 即 可 ， 具 
体 代 码 如 下 : 
private boolean needExit = 包 lse; // 是 否 需要 退出 App 





























// 在 发 生物 理 按键 动作 时 触发 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
让 (keyCode 一 KeyEvent.KEYCODE_BACK) { // 按 下 返回 键 
if (needExit) { 
finish(); / 关闭 当前 页 面 
} 
needExit = true; 
Toast.makeText(this, "再 按 一 次 返回 键 退出 !", Toast.LENGTH_SHORT).show(); 
return true; 
} else { 
return super.onKeyDown(keyCode, event); 
} 
| 


重 写 Activity 代码 的 onBackPressed 方法 可 实现 同样 的 效果 ， 该 方法 专门 响应 按 返 回 键 事 
件 ， 有 具体 代码 如 下 : 
private boolean needExit = false; // 是 否 需 要 退出 App 


// 在 按 下 返回 键 时 触发 
public void onBackPressedO { 
if (needExit) { 
finish(); / 关闭 当前 页 面 
return; 
} 
needExit = true; 
Toast.makeText(this, "再 按 一 次 返回 键 退出 !", Toast.LENGTH_SHORT).show0; 
b 


该 功能 的 界面 效果 如 图 11-3 所 示 。 这 是 一 个 提示 小 窗口 , 在 淘宝 主页 按 返 回 键 时 能 够 看 到 。 














再 按 一 次 返回 键 退出 ! 





图 11-3 “再 按 一 次 返回 键 退出 ”的 提示 窗口 
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11.1.3 ”音量 调节 对 话 框 


除了 检测 回 车 键 与 返回 键 , 音量 键 也 常常 需要 拦截 。 第 9 章 提 到 Android 有 6 类 铃 音 , 分 
别 是 通话 音 、 系 统 音 、 铃 音 、 媒 体 音 、 闹 钟 音 和 通知 音 ， 不 过 音量 键 具 有 加 大 与 减少 两 个 键 ， 
当 用 户 按 音 量 增 加 键 时 ，App 怎么 知道 用 户 希望 加 大 哪 类 铃 音 的 音量 呢 ? 

要 解决 这 个 问题 ， 最 好 是 弹出 一 个 对 话 框 ， 让 用 户 选择 希望 调节 的 铃 音 类 型 ， 并 显示 拖 
动 条 ,方便 用 户 把 音量 一 次 调整 到 位 ,不 必 连 续 按 增 加 键 或 减 小 键 。 自 定义 音量 对 话 框 还 有 一 
个 好 处 ， 即 允许 定制 对 话 框 的 界面 风格 与 显示 位 置 ， 这 在 播放 音乐 和 播放 电影 时 尤其 适用 。 

因为 自 定义 对 话 框 的 代码 不 在 Activity 中 ， 所 以 无 法 通过 onKeyDown 方法 检测 按键 ， 只 

E 给 拖 动 条 注册 按键 监听 器 OnKeyListener。 自 定义 音量 调节 对 话 框 的 代码 如 下 : 
public class VolumeDialog implements OnSeekBarChangeListener OnKeyListener { 
private Dialog dialog; / 声明 一 个 对 话 框 对 象 
private View view; / 声明 一 个 视图 对 象 
private SeekBar sb_music; / 声明 一 个 拖 动 条 对 象 
private AudioManager mAudioMgr; ”// 声明 一 个 音频 管理 器 对 象 
private int MUSIC =AudioManagerSTREAM_MUSIC; // 音乐 的 音频 流 类 型 
private int mMaxVolume; / 最 大 音量 
private int mNowVolume;”// 当前 音量 

















public VolumeDialog(Context context) { 

// 从 系统 服务 中 获取 音频 管理 器 

mAudioMegr = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE); 

/ 获取 指定 音频 类 型 的 最 大 音量 

mMaxVolume = mAudioMegr.getStreamMax Volume(MUSIC):; 

/ 获取 指定 音频 类 型 的 当前 音量 

mNowVolume = mAudioMegr.getStreamVolume(MUSIC); 

/ 根据 布局 文件 dialog_volume.xml 生成 视图 对 象 

view = LayoutInflater.from(context).inflate(R.layout.dialog_volume, null); 

/ 创建 一 个 指定 风格 的 对 话 框 对 象 

dialog = new Dialog(context, R.style.VolumeDialog); 

/ 从 布局 文件 中 获取 名 叫 sb_music 的 拖 动 条 

sb music = view.findViewById(R.id.sb_music); 

/ 设置 拖 动 条 的 拖 动 变更 监听 器 

sb_music.setOnSeekBarChangeListener(this); 

// 设置 拖 动 条 的 拖 动 进度 

sb_music.setProgress(sb_music.getMax() * mNowVolume / mMax Volume); 
b 


// 显示 对 话 框 

public void showO { 
/ 设置 对 话 框 窗口 的 内 容 视 图 
dialog.getWindow().setContentView(view); 


第 11 章 事件 | 475 





/ 设置 对 话 框 窗口 的 布局 参数 

dialog.getWindow().setLayout(LayoutParams.MATCH PARENT, 
LayoutParams.WRAP_ CONTENT); 

dialog.show(0; // 显示 对 话 框 

/ 设置 拖 动 条 允许 获得 焦点 

sb_music.setFocusable(true); 

/ 设置 拖 动 条 在 触摸 情况 下 允许 获得 焦点 

sb_music.setFocusableInTouchMode(true); 

/ 设置 拖 动 条 的 按键 监听 器 

sb_music.setOnKeyListener(this); 

} 


/ 关闭 对 话 框 
public void dismiss() { 
/ 如 果 对 话 框 显 示 出 来 了 ， 就 关闭 它 
if (dialog != null && dialog.isShowing() { 
dialog.dismiss(); / 关闭 对 话 框 
} 
有 


/ 判断 对 话 框 是 否 显示 
public boolean isShowing() { 
if (dialog {= null) { 
return dialog.isShowing(); 
}else { 
return false; 
!; 
中 


// 按 音量 方向 调整 音量 
public void adjustVolume(int direction, boolean fromActivity) { 
让 (direction 一 AudioManager.ADJUST_RAISE) { // 调 大 音量 
mNowVolume++; 
}else { // 调 小 音量 
mNowVolume—:; 
} 
/ 设置 拖 动 条 的 当前 进度 
sb_music.setProgress(sb_music.getMax() * mNowVolume / mMax Volume); 
/ 把 该 音频 类 型 的 当前 音量 往 指定 方向 调整 
mAudioMsgradjustStreamVolume(MUSIC, direction, AudioManager.FLAG PLAY_ SOUND); 
if (mListener != null && !fromActivity) { 
mListener.onVolumeAdjust(m Now Volume); 
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close(; 
由 


/ 准备 关闭 对 话 框 

private void closeO { 
/ 移 除 原来 的 对 话 框 关 闭 任务 
mHandler.removeCallbacks(mClose); 
/ 延迟 两 秒 后 启动 对 话 框 关 闭 任务 
mHandler.postDelayed(mClose, 2000); 

! 


private Handler mHandler = new Handler(); / 声明 一 个 处 理 器 对 象 
// 声明 一 个 关闭 对 话 框 任务 
private Runnable mClose = new Runnable() { 
public void run0O) { 
dismiss(); 
} 
引 


// 在 进度 变更 时 触发 。 第 三 个 参数 为 true 表示 用 户 拖 动 ， 为 false 表示 代码 设置 进度 
public void onProgressChanged(SeekBar seekBar int progress, boolean fromUser) {} 


// 在 开始 拖 动 进度 时 触发 
public void onStartTrackingTouch(SeekBar seekBar) {} 


/ 在 停止 拖 动 进度 时 触发 
public void onStopTrackingTouch(SeekBar seekBar) { 
/ 计算 拖 动 后 的 当前 音量 
mNowVolume = mMaxVolume * seekBar.getProgress() / seekBar.getMax0; 
/ 设置 该 音频 类 型 的 当前 音量 
mAudioMgr.setStreamVolume(MUSIC, mNowVolume, AudioManager.FLAG PLAY_SOUND); 
if (mListener !=null) { 
mListener.onVolume Adjust(mNowVolume); 
} 
close(); 
} 


// 在 发 生 按键 动作 时 触发 
public boolean onKey(View v, int keyCode, KeyEvent event) { 
if (keyCode 一 KeyEvent KEYCODE VOLUME UP 
&& event.getAction() 一 KeyEvent.ACTION_DOWN) { // 按 下 了 音量 加 键 
adjustVolume(AudioManager.ADJUST_RAISE, false); / 调 大 音量 
return true; 
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} elseif(keyCode 一 KeyEventKEYCODE VOLUME _ DOWN 
&& event.getAction() 一 KeyEventACTION_ DOWN) { // 按 下 了 音量 减 键 
adjustVolume(AudioManager.ADJUST_LOWER, false); / 调 小 音量 
return true; 
}else{ 
return false; 


private VolumeAdjustListener mListener; / 声明 一 个 音量 调节 的 监听 器 对 象 

/ 设置 音量 调节 监听 器 

public void setVolumeAdjustListener(VolumeAdjustListener listener) { 
mListener = listener; 


// 定义 一 个 音量 调节 的 监听 器 接口 
public interface VolumeAdjustListener { 
void onVolumeA djust(int volume); 


} 
在 页 面 代码 中 通过 检测 音量 增加 键 和 减 小 键 弹出 音量 对 话 框 ， 代 码 如 下 : 


public class VolumeSetActivity extends AppCompatActivity implements VolumeAdjustListener { 
private TextView tv_volume; 
private VolumeDialog dialog; // 声明 一 个 音量 调节 对 话 框 对 象 
private AudioManager mAudioMgr， / 声明 一 个 音量 管理 器 对 象 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_volume_set); 
tv_volume = findViewById(R.id.tv_volume); 
/ 从 系统 服务 中 获取 音量 管理 器 
mAudioMgr = (AudioManager) getSystemService(Context.AUDIO_SERVICE); 


/ 在 发 生物 理 按键 动作 时 触发 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode 一 KeyEventKEYCODE VOLUME UP 
&& event.getAction() 一 KeyEvent.ACTION_DOWN) { // 按 下 音量 加 键 
/ 显示 音量 调节 对 话 框 ， 并 将 音量 调 大 一 级 
showVolumeDialog(AudioManagerADJUST_RAISE); 
return true; 
} else if (keyCode 一 KeyEventKEYCODE VOLUME DOWN 
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&& event.getAction() 一 KeyEvent.ACTION_DOWN) { // 按 下 音量 减 键 

// 显示 音量 调节 对 话 框 ， 并 将 音量 调 小 一 级 
showVolumeDialog(AudioManager.ADJUST _ LOWER); 
return true; 

} else if (keyCode 一 KeyEventKEYCODE_BACK) { // 按 下 返回 键 
finish0); // 关闭 当前 页 面 
return false; 

} else { // 其 他 按键 
return false; 

} 

} 


// 显示 音量 调节 对 话 框 
private void showVolumeDialog(int direction) { 
if (dialog == null || !dialog.isShowing()) { 
// 创建 一 个 音量 调节 对 话 框 
dialog = new VolumeDialog(this); 
/ 设置 音量 调节 对 话 框 的 音量 调节 监听 器 
dialog.setVolumeAdjustListener(this); 
/ 显示 音量 调节 对 话 框 
dialog.show0); 
} 
/ 令 音量 调节 对 话 框 按 音 量 方向 调整 音量 
dialog.adjustVolume(direction, true); 
onVolumeAdjust(mAudioMgr.getStreamVolume(AudioManager.STREAM_MUSIO)); 
b 


/ 在 音量 调节 完成 后 触发 
public void onVolumeAdjust(int volume) { 
tv_volume.setText(" 调 节 后 的 音乐 音量 大 小 为 : "+ volume); 
1 
} 
音量 调节 对 话 框 的 效果 如 图 11-4 和 图 11-5 所 示 。 其 中 ， 如 图 11-4 所 示 为 在 主页 面 按 音 
量 增 加 键 时 弹出 音量 对 话 框 的 界面 ， 用 户 把 对 话 框 上 的 拖 动 条 向 左 拉 ， 以 大 幅 减 小 音乐 音量 ， 


此 时 的 音量 对 话 框 界面 如 图 11-5 所 示 。 
es 


11-4 按 音 量 增加 键 弹出 对 话 框 图 11-5 ”把 对 话 框 上 的 拖 动 条 往 左 拉 
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11.2 ”触摸 事件 


本 节 介绍 对 屏幕 触摸 事件 的 相关 处 理 ， 首 先 说明 手 势 事件 的 分 发 流程 ， 包 括 3 个 手势 方 
法 、3 类 手势 执行 者 、 派 发 与 拦截 处 理 ;然后 说 明 手 势 事件 的 具体 用 法 ， 包 括 单 点 触摸 和 多 点 
触 控 ， 最 后 阐述 一 个 手势 触摸 的 具体 应 用 一 一 手写 签名 功能 的 实现 。 


11.2.1 手势 事件 的 分 发 流程 


智能 手机 的 一 大 革命 性 技术 是 把 屏幕 变 为 可 触摸 设备 ， 既 可 用 于 信息 输出 〈 显 示 界 面 ) 
又 可 用 于 信息 输入 检测 用 户 的 触摸 行为 ) 。 为 方便 开发 者 使 用 ，Android 已 经 自动 识别 特定 
的 几 种 触摸 手势 , 包括 按钮 的 点 击 事件 (OnClickListener) 、 长 按 事件 (OnLongClickListener) 、 
滚动 视图 ScrollView 的 上 下 滚动 事件 、 翻 页 视图 ViewPager 的 左右 翻 页 事件 等 。 不 过 对 于 App 的 
高 级 开发 来 说 ， 系 统 自 带 的 几 个 固定 手势 显然 无 法 满足 丰富 多 变 的 业务 需求 。 这 时 就 要 求 开发 者 
深入 了 解 触摸 行为 的 流程 与 方法 ， 并 在 合适 的 场合 接管 触摸 行为 ， 进 行 符合 需求 的 事件 处 理 。 

与 手势 事件 有 关 的 方法 主要 有 3 个 〈 按 执行 顺序 排列 ) : dispatchTouchEvent、 


onInterceptTouchEvent 和 onTouchEvent。 


e@ dispatchTouchEvent: 进行 事件 分 发 处 理 ， 返 回 结果 表示 该 事件 是 否 需要 分 发 。 默 认 返 回 
true 表示 分 发 给 下 级 视图 ， 由 下 级 视图 处 理 该 手势 ， 不 过 最 终 是 否 分 发 成 功 还 得 根据 
onInterceptTouchEvent 方法 的 拦截 判断 结果 ; 返回 false 表示 不 分 发 ， 此 时 必须 实现 自身 
的 onTouchEvent 方法 ， 和 否则 该 手势 将 不 会 得 到 处 理 。 

e@ onInterceptTouchEvent: 进行 事件 拦截 处 理 , 返回 结果 表示 当前 容器 是 否 需要 拦截 该 事件 。 
返回 true 表示 予以 拦截 ,该 手势 不 会 分 发 给 下 级 视图 , 此 时 必须 实现 自身 的 onTouchEvent 
方法 ， 否 则 该 手势 将 不 会 得 到 处 理 ; 默认 返回 false 表示 不 拦截 , 该 手势 会 分 发 给 下 级 视 
图 进行 后 续 处 理 。 

。 onTouchEvent: 进行 事件 触摸 处 理 ， 返 回 结果 表示 该 事件 是 否 处 理 完毕 。 返 回 true 表示 
处 理 完 毕 ， 无 须 处 理 上 级 视图 的 onTouchEvent 方法 ， 一 路 返回 结束 流程 ; 返回 false 表 
示 该 手势 事件 尚未 完成 ， 返 回 继续 处 理 上 级 视图 的 onTouchEvent 方法 ， 然 后 根据 上 级 
onTouchEvent 方法 的 返回 值 判断 直接 结束 或 由 上 上 级 处 理 。 

上 述 手 势 方法 的 执行 者 有 3 个 〈 按 执行 顺序 排列 ) : 页 面 类 、 容 器 类 和 控件 类 。 

e@ 页 面 类 : 包括 Activity 及 其 派生 类 。 页 面 类 可 操作 dispatchTouchEvent 和 onTouchEvent 
两 种 方法 。 

e@ 容器 类 : 包括 从 ViewGroup 类 派生 出 的 各 类 容器 ， 如 各 种 布局 Layout， 以 及 ListView、 
GridView 、 Spinner 、 ViewPager 、 RecyclerView 、 Toolbar 等 。 容 器 类 可 操作 
dispatchTouchEvent、onlInterceptTouchEvent 和 onTouchEvent 三 种 方法 。 

e@ 控件 类 : 包括 从 View 类 派生 的 各 类 控件 ， 如 TextView、ImageView、Button 等 。 控 件 类 
可 操作 dispatchTouchEvent 和 onTouchEvent 两 种 方法 。 
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可 以 看 出 , 只 有 容器 类 才能 操作 onInterceptTouchEvent 方法 , 这 是 因为 该 方法 用 于 拦截 发 
往 下 层 视图 的 事件 ， 而 控件 类 已 经 位 于 底层 ， 只 能 被 拦截 ， 不 能 拦截 别人 。 页 面 类 不 拥有 下 层 
视图 ， 所 以 不 能 操作 onInterceptTouchEvent 方法 。 

以 上 涉及 3 个 手势 方法 和 3 种 手势 执行 者 ， 其 中 手势 流程 的 排列 组 合 千变万化 ， 并 不 容 
易 解 释 清楚 。 对 于 实际 开发 来 说 , 真正 需要 处 理 的 组 合并 不 多 , 所 以 只 要 把 常见 的 几 种 组 合 搞 
清楚 ， 就 能 应 付 大 部 分 开发 工作 。 


(1) 首先 是 页 面 类 的 手势 处 理 ， 其 dispatchTouchEvent 必须 返回 tue， 因 为 如 果 不 分 发 ， 
页 面 上 的 视图 就 无 法 处 理 手 势 。 至 于 页 面 类 的 onTouchEvent， 基 本 没什么 作用 ， 因 为 手势 动作 
由 具体 视图 处 理 ， 页 面 直接 处 理 手 势 没 什么 意义 。 所 以 页 面 类 的 手势 处 理 可 以 不 用 关心 ， 直 接 

(2) 其 次 是 控件 类 的 手势 处 理 ， 其 dispatchTouchEvent 没有 任何 作用 ， 因 为 控件 下 面 没 
有 下 级 视图 ， 无 所 谓 分 不 分 发 。 至 于 控件 类 的 onTouchEvent， 如 果 要 进行 手势 处 理 ， 就 需要 
自 定义 一 个 控件 ， 重 写 自 定义 类 中 的 onTouchEvent 方法 ; 如 果 不 想 自 定义 控件 ， 就 直接 调用 
控件 对 象 的 setOnTouchListener 方法 , 注册 一 个 触摸 监听 器 OnTouchListener, 并 实现 该 监听 器 
的 onTouch 方法 。 所 以 控件 类 的 手势 处 理 只 需 关 心 onTouchEvent 方法 。 

(3) 最 后 是 容器 类 的 手势 处 理 ， 这 才 是 真正 要 深入 了 解 的 地 方 。 容 器 类 的 
dispatchTouchEvent 与 onInterceptTouchEvent 两 个 方法 都 能 决定 是 否 将 手势 交 给 下 级 视图 处 
理 。 为 了 避免 手势 响应 冲突 ， 一 般 要 重 写 dispatchTouchEvent 方法 或 onInterceptTouchEvent 方 
法 。 这 两 个 方法 之 间 的 区 别 可 以 这 么 理解 : 前 者 是 大 领导 ， 只 管 派发 任务 ， 不 会 自己 做 事情 ; 
后 者 是 小 领导 ， 尽 管 有 拦截 的 权利 ， 不 过 也 得 自己 做 点 事情 ， 比 如 处 理 纠 纷 。 容 器 类 的 
onTouchEvent 近乎 摆设 ， 因 为 需要 拦截 的 在 前 面 已 经 拦截 了 ， 需 要 处 理 的 在 下 级 视图 已 经 处 
理 了 ， 很 少 会 忽 一 大 圈 在 这 儿 处 理 。 


经 过 上 面 的 详细 分 析 ， 常 见 的 手势 处 理 方法 有 下 面 3 种 。 

e 容器 类 的 dispatchTouchEvent 方法 : 控制 事件 的 分 发 ， 决 定 把 手势 交 给 谁 处 理 。 

e@ 容器 类 的 onInterceptTouchEvent 方法 : 控制 事件 的 拦截 ， 决 定 是 否 要 把 手势 交 给 下 级 视 
图 处 理 。 

e 控件 类 的 onTouchEvent 方 法 : 进行 手势 事件 的 具体 处 理 。 

下 面 是 一 个 不 派发 事件 的 自 定义 布局 代码 : 


public class NotDispatchLayout extends LinearLayout { 








public NotDispatchLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 
上 


/ 在 分 发 触摸 事件 时 触发 
public boolean dispatchTouchEvent(MotionEvent ev) { 
if (mListener !=nullD) { 
mListener.onNotDispatch(); 
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/ 一 般 容器 默认 返回 tue， 即 允许 分 发 给 下 级 
Teturn false; 


} 


private NotDispatchListener mListener; / 声明 一 个 分 发 监听 器 对 象 

/ 设置 分 发 监听 器 

public void setNotDispatchListener(NotDispatchListener listener) { 
mListener = listener; 


四 


/ 定义 一 个 分 发 监听 器 接口 
public interface NotDispatchListener { 
void onNotDispatch(); 
} 
} 
活动 页 面 实 现 的 onNotDispatch 方法 代码 如 下 : 


// 在 分 发 触摸 事件 时 触发 
public void onNotDispatch() { 
desc_no = String.format("%s%s 触摸 动作 未 分 发 ， 按 钮 点 击 不 了 了 \n" 
, desc_no, DateUtil.getNowTime()); 
tv_dispatch_no.setText(desc_no); 
不 派发 事件 的 处 理 效 果 如 图 11-6 和 图 11-7 所 示 。 其 中 ， 图 11-6 的 上 面部 分 为 正常 布局 ， 
此 时 按钮 可 正常 响应 点 击 事件 ; 图 11-7 的 下 面部 分 为 不 派发 布局 ， 此 时 按钮 不 会 响应 点 击 事 
件 ， 取 而 代 之 的 是 执行 不 派发 布局 的 onNotDispatch 方法 。 











这 里 允许 分 发 给 下 级 这 里 允许 分 发 给 下 级 
13:57:29 您 点 击 了 按钮 13:57:29 您 点 击 了 按钮 


这 里 不 允许 发 给 下 级 这 里 不 允许 发 给 下 级 
13:58:02 触摸 动作 未 分 发 ， 按 钮 点 击 不 了 了 








图 11-6 正常 布局 允许 分 发 事件 图 11-7 不 派发 布局 未 分 发 事件 
再 来 看 看 拦截 事件 的 自 定义 布局 代码 : 


public class InterceptLayout extends LinearLayout { 








public InterceptLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 
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} 


// 在 拦截 触摸 事件 时 触发 
public boolean onInterceptTouchEvent(MotionEvent ev) { 
if (mListener !=null) { 
mListener.onIntercept(); 
} 
// 一 般 容器 默认 返回 包 se， 即 不 拦截 。 但 滚动 视图 ScrollView 会 拦截 
Teturn true; 


} 


private InterceptListener mListener; / 声明 一 个 拦截 监听 器 对 象 

/ 设置 拦截 监听 器 

public void setInterceptListener(InterceptListener listener) { 
mListener = listener; 


) 


/ 定义 一 个 拦截 监听 器 接口 
public interface InterceptListener { 
void onJIntercept(; 
) 
} 


活动 页 面 实 现 的 onIntercept 方法 代码 如 下 : 


// 在 拦截 触摸 事件 时 触发 
public void onInterceptO { 
desc_yes = String.format("%s%s 触摸 动作 被 拦截 ， 按 钮 点 击 不 了 了 \n", desc_yes， 
DateUtil.getNowTime()); 
tv_intercept_yes.setText(desc_yes); 
| 
拦截 事件 的 处 理 效果 如 图 11-8 和 图 11-9 所 示 。 其 中 ， 图 11-8 的 上 面部 分 为 正常 布局 ， 
此 时 按钮 可 正常 响应 点 击 事件 ; 图 11-9 的 下 面部 分 为 拦截 布局 ， 此 时 按钮 不 会 响应 点 击 事件 ， 
取而代之 的 是 执行 拦截 布局 的 onIntercept 方法 。 











这 里 不 拦截 下 级 的 事件 这 里 不 拦截 下 级 的 事件 
13:56:22 您 点 击 了 按钮 13:56:22 您 点 击 了 按钮 


这 里 拦截 了 下 级 的 事件 这 里 拦截 了 下 级 的 事件 
13:57:05 触摸 动作 被 拦截 ， 按 钮 点 击 不 了 了 





图 11-8 ”正常 布局 不 拦截 事件 图 11-9 拦截 布局 拦截 事件 
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11.2.2 ”手势 事件 处 理 MotionEvent 


dispatchTouchEvent、onInterceptTouchEvent 和 onTouchEvent 的 输入 参数 都 是 手势 事件 
MotionEvent， 其 中 包含 触摸 动作 的 所 有 信息 ， 各 种 手势 操作 都 得 到 MotionEvent 中 获取 信息 
并 进行 判断 处 理 。 

下 面 是 MotionEvent 的 常用 方法 说 明 。 

e@ getAction: 获取 当前 的 动作 类 型 。 动 作 类 型 的 取 值 说 明 见 表 11-2。 


表 11-2 ”动作 类 型 的 取 值 说 明 

















MotionEvent 类 的 动作 类 型 说 明 
ACTION_DOWN 按 下 动作 
ACTION_UP 提起 动作 
ACTION MOVE 移动 动作 
ACTION_CANCEL 取消 动作 
ACTION_OUTSIDE 移出 边界 动作 
ACTION_POINTER_DOWN 第 二 个 点 的 按 下 动作 ， 用 于 多 点 触 控 的 判断 
ACTION_POINTER_UP 第 二 个 点 的 提起 动作 ， 用 于 多 点 触 控 的 判断 
ACTION MASK 动作 掩 码 ， 与 原 动 作 类 型 进行 “与 ”(&) 操作 后 获得 多 点 触 控 信息 
。 getEventTime: 获取 事件 时 间 ( 从 开机 到 现在 的 毫秒 数 ) 。 
e getX: 获取 在 控件 内 部 的 相对 横 坐 标 。 
e getY: 获取 在 控件 内 部 的 相对 纵 坐 标 。 
。 getRawX: 获取 在 屏幕 上 的 绝对 横 坐 标 。 
。 getRawY: 获取 在 屏幕 上 的 绝对 纵 坐标 。 
egetPressure: 获取 触摸 的 压力 大 小 。 
egetPointerCount: 获取 触 控 点 的 数量 ， 如果 为 2 就 表示 有 两 个 手指 同时 按压 屏幕 。 如 果 触 


控 点 数目 大 于 1， 坐 标 相关 方法 就 可 输入 整 型 编号 ， 表 示 获 取 第 几 个 触 控 点 的 坐标 信息 。 
下 面 是 演示 单 点 触摸 的 页 面 代码 : 


public class TouchSingleActivity extends AppCompatActivity { 
private TextView tv_touch; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_touch_single); 
tv_touch = findViewById(R.id.tv_touch); 

上 


/ 在 发 生 触 摸 事件 时 触发 
public boolean onTouchEvent(MotionEvent event) { 
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// 从 开机 到 现在 的 毫秒 数 

int seconds = (inb (event.getEventTime() / 1000); 

int hour = seconds /3600; 

intminute = seconds % 3600 / 60; 

int second = seconds % 60; 

String desc = String.format(" 动 作 发 生 时 间 : 开机 距离 现在 %02d:%02d:%02d", 

hour, minute, second); 

desc = String.format("%s\n 动作 名 称 是 : ", desc); 

// 获得 触摸 事件 的 动作 类 型 

int action = event.getAction(); 

让 (action == MotionEvent.ACTION_DOWN) { // 手指 按 下 
desc = String.format("%s 按 下 ", desc); 

} else if (action 一 MotionEvent.ACTION_MOVE) { / 手指 移动 
desc = String.format("%s 移动 ", desc); 

} else if (action 一 MotionEvent.ACTION_UP) { // 手指 松 开 
desc = String.format("%s 提起 ", desc); 

} else if (action 一 MotionEvent.ACTION_CANCEL) { // 取消 手势 
desc = String.format("%s 取消 ", desc); 

} 

desc = String.format("%sm 动作 发 生 位 置 是 : 横 坐 标 %f， 纵 坐标 %f", 

desc, event.getX(), event.getYO); 
tv_touch.setText(desc); 
return super.onTouchEvent(event); 


} 


单 点 触摸 的 效果 如 图 11-10、 图 11-11、 图 11-12 所 示 。 其 中 ， 如 图 11-10 所 示 为 手势 按 下 
时 的 检测 界面 ， 如 图 11-11 所 示 为 手势 移动 时 的 检测 界面 ， 如 图 11-12 所 示 为 手势 提起 时 的 检 
测 界面 。 


动作 发 生 时 间 : 开机 距离 现在 00:23:52 动作 发 生 时 间 ; 开机 距离 现在 00:25:08 动作 发 生 时 间 : 开机 距离 现在 00:25:11 
是 : 移动 动作 名 称 : 


动作 名 称 下 动作 名 称 : 
动作 发 生 : 横 坐 标 279.514740 ， 纵 坐 发 生 位 


动作 : : 横 坐标 299.949188， 纵 坐 动作 : 位 : 横 坐 标 299.949188， 纵 坐 
标 472.538544 标 472.538544 





11-10 手势 按 下 时 的 界面 图 11-11 手势 移动 时 的 界面 图 11-12 手势 提起 时 的 界面 
除了 单 点 触摸 ， 智 能 手机 还 普遍 支持 多 点 触 控 ， 即 响应 两 个 及 以 上 手指 同时 按压 屏幕 。 
多 点 触 控 可 用 于 操纵 图 像 的 缩放 与 旋转 操作 ， 以 及 需要 多 点 处 理 的 游戏 界面 。 
下 面 是 演示 多 点 触 控 的 页 面 代码 : 
public class TouchMultipleActivity extends AppCompatActivity { 
private TextView tv_touch_major; 





private TextView tv_touch_minor; 
private boolean isMinorPressed = false; / 是 否 存 在 次 要 点 触摸 
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protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_touch_multiple); 
tv_touch major = findViewById(R.id.tvy_touch major); 
tv_touch minor= findViewById(R.id.tv_touch_minor); 


/ 在 发 生 触 摸 事件 时 触发 
public boolean onTouchEvent(MotionEvent event) { 


// 从 开机 到 现在 的 毫秒 数 

int seconds = (inb (event.getEventTime() / 1000); 
int hour = seconds /3600; 

int minute = seconds % 3600 / 60; 

int second = seconds % 60; 


String desc_major = String.format(" 主 要 动作 发 生 时 间 : 开机 距离 现在 %02d:%02d:%02dn%s"， 


hour, minute, second, "主要 动作 名 称 是 :"); 
String desc_minor = ""; 
// 获得 包括 次 要 点 在 内 的 触摸 行为 
int action = event.getAction() & MotionEventACTION_MASK; 
让 (action 一 MotionEvent.ACTION_DOWN) { // 手指 按 下 
desc_major = String.format("%s 按 下 ", desc_major); 
} else if (action 一 MotionEvent.ACTION_MOVE) { // 手指 移动 
desc_major = String.format("%s 移动 ", desc_major); 
if (isMinorPressed) { 
desc_minor = String.format("%s 次 要 动作 名 称 是 : 移动 ", desc_minor); 
} 
} else if (action 一 MotionEvent.ACTION_UP) { // 手指 松 开 
desc_major = String.format("%s 提起 ", desc_major); 
} else if (action 一 MotionEvent.ACTION_CANCEL) { / 取消 手势 
desc_ major= String.format("%s 取消 ", desc_major); 
} else if (action 一 MotionEvent.ACTION_POINTER_DOWN) { // 次 要 点 按 下 
isMinorPressed = true; 
desc_minor = String.format("%s 次 要 动作 名 称 是 : 按 下 ", desc_minor); 
} elseif action 一 MotionEvent.ACTION_POINTER_UP) { // 次 要 点 松 开 
isMinorPressed = false; 
desc_minor = String.format("%s 次 要 动作 名 称 是 : 提起 ", desc_minor); 
和 
desc_major = String.format("%sin 主要 动作 发 生 位 置 是 : 横 坐 标 %f， 纵 坐标 %f" 
desc major event.getX(), event.getY()); 
tv_touch_major.setText(desc_ major); 
证 (isMinorPressed || !TextUtils.isEmpty(desc_minor)) { / 存在 次 要 点 触摸 


desc_minor = String.format("%s\n 次 要 动作 发 生 位 置 是 : 横 坐 标 %f， 纵 坐标 %f"， 
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desc_minor, event.getX(1), event.getY(1)); 
tv_touch minor.setText(desc_minor); 
} 


return super.onTouchEvent(event); 


| 


多 点 触 控 的 效果 如 图 11-13 和 图 11-14 所 示 。 其 中 ， 如 图 11-13 所 示 为 两 个 手指 一 起 按 下 
时 的 检测 界面 ， 如 图 11-14 所 示 为 两 个 手指 一 齐 提起 时 的 检测 界面 。 








坐标 766.401245 
图 11-13 ”两 个 手指 一 齐 按 下 时 的 界面 图 11-14 ”两 个 手指 一 齐 提起 时 的 界面 
11.2.3 ”手写 签名 
为 了 加 深 对 触摸 事件 的 认识 ， 接 下 来 我 们 通过 实现 一 个 手写 签名 控件 进一步 理解 手势 处 
理 的 应 用 场合 


写 签名 的 原理 是 把 手机 屏幕 当 作 画板 ， 把 用 户 手指 当 作画 笔 手指 在 屏幕 上 划 来 划 去 
屏幕 就 会 显示 手指 的 移动 轨迹 , 就 像 画 笔 在 画板 上 写字 一 样 。 实现 手写 签名 需要 结合 给 图 的 路 
径 工具 Path， 在 有 按 下 动作 时 调用 Path 对 象 的 moveTo 方法 ， 将 路 径 起 始点 移 到 触摸 点 ， 在 
有 移动 操作 时 调用 Path 对 象 的 quadTo 方法 , 将 记录 本 次 触摸 点 与 上 次 触摸 点 之 间 的 路 径 ; 在 
有 移动 操作 与 提起 动作 时 调用 Canvas 对 象 的 drawPath 方法 ， 将 本 次 触摸 轨迹 绘制 在 画布 上 。 
手写 签名 控件 的 自 定义 代码 主要 片段 如 下 : 


private Paint mPaint; / 声明 一 个 画笔 对 象 

private Canvas mCanvas; / 声明 一 个 画布 对 象 

private Bitmap mBitmap; / 声明 一 个 位 图 对 象 

private Path mPath; / 声明 一 个 路 径 对 象 

private PathPosition mPos = new PathPosition0); / 路 径 位 置 

private ArrayList<PathPosition> mPathArray = new ArrayList<PathPosition>(0); / 路 径 位 置 队列 
private float mLastX, mLastY; / 上 次 触摸 点 的 横 纵 坐标 


// 初始 化 视图 
private void initView(int width, int height) { 
mPaint = new Paint0; / 创建 新 画笔 
mPaint.setAntiAlias(true); /设置 画笔 为 无 锯齿 
mPaint.setStrokeWidthtmStrokeWidth); / 设置 画笔 的 线 宽 
ImmPaint.setStyle(Paint Style.STROKE); / 设置 画笔 的 类 型 。 STROK 表示 空心 ,FILL 表示 实心 
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mpPaint.setColortmPaintColonD; / 设置 画笔 的 颜色 

mPath = new Path(); / 创建 新 路 径 

/ 开启 当前 视图 的 绘图 缓存 

setDrawingCacheEnabled(true); 

/ 创建 一 个 空白 位 图 

mBitmap = Bitmap.createBitmap(width, height, Config.ARGB 8888); 
/ 根据 空白 位 图 创建 画布 


mCanvas = new Canvas(mBitmap); 


@Override 


protected void onDraw(Canvas canvas) { 


b 


super.onDraw(canvas); 

/ 在 画布 上 绘制 指定 位 图 
canvas.drawBitmap(mBitmap, 0, 0, null); 
// 在 画布 上 绘制 指定 路 径 线条 
canvas.drawPath(mPath, mPaint); 


/ 在 发 生 触摸 事件 时 触发 


public boolean onTouchEvent(MotionEvent event) { 


switch (event.getAction()) { 

case MotionEvent.ACTION_DOWN: // 手指 按 下 
// 移动 到 指定 坐标 点 
mPath.moveTo(event.getX(), event.getY()); 
mPos.firstX = event.getX(); 
mPos.firstY = event.getY(); 
break; 

case MotionEventACTION_MOVE: // 手指 移动 
/ 连接 上 一 个 坐标 点 和 当前 坐标 点 
mPath.quadTo(mLastX, mLastY, event.getX(), event.getY()); 
mPos.nextX = event.getX(); 
mPos.nextY = event.getY(); 
// 往 路 径 位 置 队列 添加 路 径 位 置 
mPathArray.add(mPos); 
/ 创建 新 的 路 径 位 置 
mPos =new PathPosition(); 
mPos.firstX = event.getX(); 
mPos.firstY = event.getY(); 
break; 

case MotionEvent.ACTION_UP: // 手指 松 开 
/ 在 画布 上 绘制 指定 路 径 线条 
mCanvas.drawPath(mPath, mPaint); 


mPath.reset(); 

break; 
上 
mLastX = event.getX(); 
mLastY = event.getY(); 
invalidate(); / 立刻 刷新 视图 
return tmue; 

| 


手写 签名 的 效果 如 图 11-15 和 图 11-16 所 示 。 其 中 ， 如 图 11-15 所 示 为 写 到 一 半 的 签名 界 
面 ， 如 图 11-16 所 示 为 签名 完成 的 界面 。 





11-15 ”签名 一 半 的 界面 图 11-16 ”签名 完成 的 界面 





11.3 手势 检测 


本 节 介绍 常见 手势 的 检测 与 使 用 ， 首 先 说 明 手 势 检测 器 的 原理 与 具体 用 法 ， 然 后 阐述 飞 
掠 视图 的 基本 用 法 , 利用 飞 掠 视图 实现 简单 的 横幅 轮 播 ; 最 后 结合 手势 检测 器 与 飞 掠 视图 说 明 
如 何 通 过 手势 检测 器 控制 横幅 轮 播 的 翻 页 动作 。 


11.3.1 手势 检测 器 GestureDetector 


由 于 触摸 事件 的 检测 与 识别 比较 烦琐 ， 因 此 Android 提供 了 手势 检测 器 GestureDetector 
帮助 开发 者 识别 手势 。 利 用 GestureDetector 可 以 自动 辨别 常用 的 几 个 手势 事件 ， 如 点 击 、 长 
按 、 滑 动 等 ， 从 而 使 开发 者 专注 于 业务 逻辑 ， 不 必 在 手势 的 行为 判断 上 绞 尽 脑汁 。 

下 面 是 GestureDetector 的 常用 方法 。 


@ 构造 函数 : 注册 手势 监听 器 OnGestureListener， 该 监听 器 提供 了 若干 种 手势 方法 ， 需 要 
重 写 以 接管 对 应 的 事件 处 理 。 手 势 方法 说 明 如 下 : 


> onDown: 在 用 户 按 下 时 触发 。 

> onShowPress: 已 按 下 但 还 未 滑动 或 松 开 时 触发 ， 通 常用 于 按 下 状态 时 的 高 亮 显示 。 

> onSingleTapUp: 在 用 户 轻 点 一 下 弹 起 时 触发 ， 通 常用 于 点 击 事件 。 按 下 时 间 在 0.5 秒 内 为 
点 击 。 
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> onScroll: 在 用 户 滑动 过 程 中 触发 。 

> onLongPress: 在 用 户 长 按时 触发 ， 通 常用 于 长 按 事件 。 按 下 时 间 超 过 0.5 秒 为 长 按 。 

> onFling: 在 用 户 飞快 地 滑 出 一 段 距离 时 触发 ， 通 常用 于 翻 页 事件 。 该 方法 的 前 两 个 参数 
为 滑动 开始 和 结束 时 的 事件 信息 ,后 面 两 个 参数 分 别 为 滑动 操作 在 横 坐 标 上 的 滑动 速率 和 
在 纵 坐 标 上 的 滑动 速率 。 


上 述 手势 方法 有 部 分 需要 返回 布尔 值 ， 返 回 true 表示 该 手势 已 经 被 处 理 了 ， 其 他 人 不 需 
要 再 做 无 用 功 ; 返回 false 表示 该 手势 没 被 处 理 ， 留 给 其 他 人 处 理 。 
e onTouchEvent: 由 手势 检测 器 接管 对 应 视图 的 触摸 事件 。 


下 面 是 使 用 OnGestureListener 的 代码 : 


public class GestureDetectorActivity extends AppCompatActivity { 
private TextView tv_gesture; 
private GestureDetector mGesture; / 声明 一 个 手势 检测 器 对 象 
Private String desc = ""; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_gesture_detector); 
tv_gesture = findViewById(R.id.tvy_gesture); 
/ 创建 一 个 手势 检测 器 
mGesture = new GestureDetector(this, new MyGestureListener()); 


) 


/ 在 分 配 触摸 事件 时 触发 
public boolean dispatchTouchEvent(MotionEvent event) { 
mGesture.onTouchEvent(event); // 命令 由 手势 检测 器 接管 当前 的 手势 事件 


return true; 


办 


// 定义 一 个 手势 检测 监听 器 
final class MyGestureListener implements GestureDetector.OnGestureListener { 


/ 在 手势 按 下 时 触发 

public final boolean onDown(MotionEvent event) { 
// onDown 的 返回 值 没 有 作用 ， 不 影响 其 他 手势 的 处 理 
return true; 

} 


// 在 手势 飞快 掠 过 时 触发 
public final boolean onFling(MotionEvent el, MotionEvent e2, float velocityX, float velocityY) { 
float offsetX = el.getX() - e2.getXO; 
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float offsetY = el.getY() - e2.getY(); 
让 (Math.abs(offsetX) > Math.abs(offsetY)) { // 水 平方 向 滑动 
if (offsetX > 0) { 
desc = String.format("%s%s 您 向 左 滑动 了 一 下 \n", desc, DateUtil.getNowTime()); 
}else { 
desc = String.format("%s%s 您 向 右 滑动 了 一 下 \n", desc, DateUtil.getNowTime()); 
} else { // 垂直 方向 滑动 
if (offsetY > 0) { 
desc = String.format("%s%s 您 向 上 滑动 了 一 下 \n", desc, DateUtil.getNowTime()); 
}else{ 
desc = String.format("%s%s 您 向 下 滑动 了 一 下 \n", desc, DateUtil.getNowTime()); 
! 
上 
tv_gesture.setText(desc); 
return true; 


} 


/ 在 手势 长 按时 触发 

public final void onLongPress(MotionEvent event) { 
desc = String.format("%s%s 您 长 按 了 一 下 下 \n", desc, DateUtil.getNowTime()); 
tv_gesture.setText(desc); 


} 


/ 在 手势 滑动 过 程 中 触发 
public final boolean onScroll(MotionEvent el, MotionEvent e2, float distanceX, float distanceY) { 
return false; 


} 


/ 在 已 按 下 但 还 未 滑动 或 松 开 时 触发 
public final void onShowPress(MotionEvent event) 分 


/ 在 轻 点 弹 起 时 触发 ， 也 就 是 点 击 时 触发 
public boolean onSingleTapUp(MotionEvent event) { 
desc = String.format("%s%s 您 轻 轻 点 了 一 下 m", desc, DateUtil.getNowTime()); 
tv_gesture.setText(desc); 
// 返回 tme 表示 我 已 经 处 理 了 ， 别 处 不 要 再 处 理 这 个 手势 
return true; 


} 
手势 检测 器 的 使 用 效果 如 图 11-17 所 示 ， 可 以 发 现 检测 到 的 手势 包括 点 击 、 长 按 、 上 下 左 
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右 滑动 等 。 





14:11:26 您 向 左 滑动 了 一 下 
14:11:29 您 向 右 滑动 了 一 下 
14:11:31 您 向 上 滑动 了 一 下 
14:11:33 您 向 下 滑动 了 一 下 
14:11:38 您 轻 轻 点 了 一 下 
14:11:41 您 长 按 了 一 下 下 





图 11-17 手势 检测 器 的 检测 结果 
11.3.2 ” 飞 掠 视图 ViewFlipper 


手机 屏幕 尺寸 不 大 ， 为 了 在 有 限 空间 中 展示 尽 可 能 多 的 信息 ，Android 设计 了 多 种 方式 显 
示 超 出 屏幕 尺寸 的 界面 ， 包 括 上 下 滚动 、 左 右 滑动 等 。 飞 掠 视图 ViewFlipper 的 层次 翻动 就 是 
其 中 一 项 技术 。 与 ViewPager 相 比 ， 两 者 都 是 一 系列 类 似 视图 的 组 合 ，ViewFlipper 更 像 是 视 
图 的 立体 排列 〈 如 现实 生活 中 的 书籍 )， 从 上 往 下 翻 页 ， ViewPager 更 像 是 一 幅 长 长 的 平面 画 


卷 ， 从 左 往 右 翻 页 。 
下 面 是 ViewFlipper 的 常用 方法 。 


setFlipInterval: 设置 每 次 翻 页 的 时 间 间 隔 。 单 位 毫秒 。 
setAutoStart: 设置 是 否 自动 开始 翻 页 。 为 tme 表示 自动 开始 。 
startFlipping: 开始 翻 页 。 

stopFlipping: 停止 翻 页 。 

isFlipping: 判断 当前 是 否 正在 翻 页 。 

showNext: 显示 下 一 个 视图 。 

showPrevious: 显示 上 一 个 视图 。 

setDisplayedChild: 设置 当前 展示 第 几 个 视图 。 
getDisplayedChild: 获取 当前 展示 的 是 第 几 个 视图 。 
setInAnimation: 设置 视图 的 移入 动画 。 
getInAnimation: 获取 移入 动画 的 动画 对 象 。 
setOutAnimation: 设置 视图 的 移出 动画 。 
getOutAnimation: 获取 移出 动画 的 动画 对 象 。 


下 面 是 利用 ViewFlipper 实现 简单 横幅 轮 播 的 代码 : 


public class ViewFlipperActivity extends AppCompatActivity implements OnClickListener { 
private Button btn_control flipper; 
private RelativeLayout rl_content; / 声明 一 个 相对 布局 对 象 
private ViewFlipper vf_content; / 声明 一 个 飞 掠 视图 对 象 
private RadioGroup rg_indicator; / 声明 一 个 单 选 组 对 象 
Private boolean isPlaying = true; // 是 否 正在 播放 


protected void onCreate(Bundle savedInstanceState) { 
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super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_view_flipper); 

btn_control flipper = findViewById(R.id.btn_control flipper); 
/ 从 布局 文件 中 获取 名 叫 rL_content 的 相对 布局 

rl _content = findViewById(R.id.rl_content); 

/ 从 布局 文件 中 获取 名 叫 banner flipper 的 飞 掠 视 图 
vf_content = findViewById(R.id.vf content); 

/ 从 布局 文件 中 获取 名 叫 rg_indicator 的 单 选 组 
rg_indicator = findViewById(R.id.rg_indicator); 
btn_control_flipper.setOnClickListener(this); 
findViewById(R.id.btn_pre_flipper).setOnClickListener(this); 
findViewById(R.id.btn_next_flipper).setOnClickListener(this); 
initFlipper0; / 初始 化 横幅 飞 掠 器 


/ 初始 化 横幅 飞 掠 器 
private void initFlipper() { 

LayoutParams params = (LayoutParams) rl_content.getLayoutParams(); 

params.height = (int) (Utils.getScreenWidth(this) * 250f / 640f); 

/ 设置 相对 布局 的 布局 参数 

IlL_content.setLayoutParams(params); 

ArrayList<Integer> imageList = ImageL ist.getDefault(); 

/ 下 面 给 每 个 图 片 都 分 配 一 个 场景 ， 并 加 入 到 飞 掠 视图 

for (Integer imagelD : imageList) { 
ImageView iv_item = new ImageView(this); 
iv_item.setLayoutParams(new LayoutParams( 

LayoutParams.MATCH PARENT, LayoutParams.MATCH PARENT)); 

iv_item.setScaleType(Image View.ScaleType.FIT_XY); 
iv_item.setImageResource(imageID); 
// 往 飞 掠 视图 添加 一 个 图 像 视图 
vf _content.addView(iv_item); 

b 

int dip_15 = Utils.dip2px(this, 15); 

// 下 面 给 每 个 图 片 都 分 配 一 个 指示 圆 点 

for (int i= 0; i < imageList.size(); i++) { 
RadioButton radio = new RadioButton(this); 
radio.setLayoutParams(new RadioGroup.LayoutParams(dip_15, dip_15)); 
radio.setGravity(Gravity.CENTER); 
radio.setButtonDrawable(R.drawable.indicator_selector); 
// 往 单 选 组 添加 一 个 指示 圆 点 
rg_indicator.addView(radio); 

} 

/ 设置 飞 掠 视图 当前 展示 的 场景 。 这 里 默认 展示 第 一 张 
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Vvf_content.setDisplayedChild(0); 

/ 让 飞 掠 视图 自动 开始 翻 页 
Vvf_content.setAutoStart(true); 

/ 延迟 200 毫秒 后 启动 指示 器 刷新 任务 
mHandler.postDelayed(mRefresh, 200); 


public void onClick(View v) { 
让 (v.getId0 一 R.id.btn_pre_flipper) { // 点 击 了 往 前 翻 页 按钮 
Vf_content.showPrevious(); / 显示 上 一 个 场景 
}else if (v.getId() 一 R.id.btn_next flipper) { // 点 击 了 往 后 翻 页 按钮 
vf_content.showNext(0); / 显示 下 一 个 场景 
} else if (v.getId() 一 R.id.btn_control_flipper) { // 点 击 了 停止 自动 翻 页 按钮 
isPlaying = !isPlaying; 
if(isPlaying) { / 正在 翻 页 
vf_content.startFlipping(); / 开始 自动 翻 页 
btn_control_flipper.setText(" 停 止 自动 翻 页 "); 
} else { // 不 在 翻 页 
vf_content.stopFlipping();，// 停止 自动 翻 页 
btn_control_flipper.setText(" 开 始 自动 翻 页 "); 


private Handler mHandler = new Handler(); / 声明 一 个 处 理 器 对 象 
// 定义 一 个 指示 器 的 刷新 任务 
private Runnable mRefresh = new Runnable() { 
(QOverride 
public void run0) { 
// 获得 正在 播放 的 场景 位 置 
int pos = vf_content.getDisplayedChild(); 
/ 根据 场景 位 置 ， 设 置 当 前 的 高 亮 指示 圆 点 
((RadioButton) rg_indicator.getChildAt(pos)).setChecked(true); 
// 延迟 200 毫秒 后 再 次 启动 指示 器 刷新 任务 
mHandler.postDelayed(this, 200); 


} 

简单 横幅 轮 播 的 效果 如 图 11-18 和 图 11-19 所 示 。 其 中 ， 如 图 11-18 所 示 为 开始 轮 播 的 界 
面 ， 通 过 按钮 控制 翻 到 上 一 页 、 翻 到 下 一 页 或 自动 进行 翻 页 ; 如 图 11-19 所 示 为 轮 播 到 第 4 张 
图 片 时 的 界面 ， 轮 播 间隔 既 可 以 在 代码 中 调用 setFlipInterval 方法 设置 ， 又 可 以 直接 在 布局 文 
件 中 指定 flipInterval 属性 。 
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11.3.3 


图 11-18 ” 飞 掠 视图 开始 轮 播 11-19 飞 掠 视图 轮 播 到 第 4 张 
手势 控制 横幅 轮 播 


前 面 演示 简单 横幅 轮 播 时 ， 需 要 通过 按钮 控制 轮 播 动作 ， 非 常 不 便 。 接 下 来 我 们 尝试 结 
合 手势 检测 器 与 飞 掠 视图 实现 手势 控制 的 轮 播 效果 。 具 体 处 理 步骤 如 下 

ET 定义 一 个 手势 检测 器 的 对 象 ， 并 在 自 定义 视图 的 dispatchTouchEvent 方法 中 声明 本 视图 
的 触摸 事件 由 该 检测 器 接管 。 

人 62 实现 手势 监听 器 的 onFling 方法 ， 在 该 方法 内 部 判断 播放 上 一 页 还 是 播放 下 一 页 ， 简 单 
实现 只 需 判 断 滑动 前 后 的 横 坐 标 偏 移 是 否 超出 阔 值 ; 若 想 更 精确 地 校 输 ， 则 可 增加 检查 横 坐 标 上 的 滑 
动 速率 是 否 达标 ， 即 判断 velocityX 是 否 超出 阐 值 。 

C703 做 一 个 简单 定时 器 , 通过 获取 当前 正在 播放 的 视图 编号 设置 下 方 指示 器 对 应 次 序 的 高 亮 





圆 点 。 




















下 面 是 手势 控制 横幅 轮 播 的 自 定义 布局 代码 : 


public class BannerFlipper extends RelativeLayout { 


private Context mContext; // 声明 一 个 上 下 文 对 象 

private ViewFlippermFlipper: / 声明 一 个 飞 掠 视图 对 象 
private RadioGroup mGroup; / 声明 一 个 单 选 组 对 象 

private GestureDetector mGesture; / 声明 一 个 手势 检测 器 对 象 
private float mFlipGap =20f // 触发 飞 掠 事件 的 距离 阔 值 


public BannerFlipper(Context context, AttributeSet attrs) { 
super(context, attrs); 
mContext = context; 
initView0: // 初始 化 视图 

b 


/ 设置 飞 掠 视图 的 图 片 队列 

public void setImage(ArrayList<Integer> imageList) { 
int dip_15 = Utils.dip2px(mContext, 15); 
// 下 面 给 每 个 图 片 都 分 配 一 个 场景 ， 并 加 入 到 飞 掠 视图 
for (mtegerimageID : imageList) { 
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ImageView iv_item = new ImageView(mContext); 
iv_item.setLayoutParams(new LayoutParams( 
LayoutParams.MATCH PARENT, LayoutParams.MATCH PARENT)); 
iv_item.setScaleType(ImageView.ScaleType.FIT_XY); 
iv_item.setImageResource(imageID); 
// 往 飞 掠 视图 添加 一 个 图 像 视图 
mFlipper.addView(iv_item); 
} 
// 下 面 给 每 个 图 片 都 分 配 一 个 指示 圆 点 
for (inti= 0; i < imageList.size(); i++) { 
RadioButton radio = new RadioButton(mContext); 
radio.setLayoutParams(new RadioGroup.LayoutParams(dip_15, dip_15)); 
radio.setGravity(Gravity.CENTER); 
radio.setButtonDrawable(R.drawable.indicator_selector); 
/ 往 单 选 组 添加 一 个 指示 圆 点 
mGroup.addView(radio); 
} 
/ 设置 飞 掠 视图 当前 展示 的 场景 。 这 里 默认 展示 最 后 一 张 
mFlipper.setDisplayedChild(imageL ist.size() - 1); 
/ 播放 下 一 个 场景 。 最 后 一 张 场景 的 下 一 张 ， 其 实 就 是 第 一 张 场景 
startFlip(); 


/ 初始 化 视图 


private void initView() { 


1 


/ 根据 布局 文件 banner_flipper.xml 生成 视图 对 象 

View view = LayoutInflater.from(mContext).inflate(R.layout.banner_flipper, nulD); 
/ 从 布局 文件 中 获取 名 叫 banner flipper 的 飞 掠 视图 

mFlipper = view.find ViewById(R.id.banner_flipper); 

// 从 布局 文件 中 获取 名 叫 rg_indicator 的 单 选 组 

mGroup = view.findViewById(R.idrg_indicator); 

addView(view); 

/ 创建 一 个 手势 检测 器 

mGesture = new GestureDetector(mContext, new BannerGestureListener()); 
/ 延迟 200 毫秒 后 启动 指示 器 刷新 任务 
mHandler.postDelayed(mRefresh, 200); 


// 在 分 配 触摸 事件 时 触发 
public boolean dispatchTouchEvent(MotionEvent event) { 


mGesture.onTouchEvent(evenb; // 命令 由 手势 检测 器 接管 当前 的 手势 事件 
return true; 
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/ 定义 一 个 手势 检测 监听 器 
final class BannerGestureListener implements GestureDetectorOnGestureListener { 


/ 在 手势 按 下 时 触发 

public final boolean onDown(MotionEvent event) { 
return true; 

} 


// 在 手势 飞快 掠 过 时 触发 
public final boolean onFling(MotionEvent el, MotionEvent e2, float velocityX, float velocityY) { 
if(el.getX() - e2.getX() > mFlipGap) { // 从 右 向 左 掠 过 
startFlip(); / 播放 下 一 个 场景 
return true; 
} 
if(el.getX() - e2.getX() <-mFlipGap) { / 从 左 向 右 掠 过 
backFlip(); / 播放 上 一 个 场景 
return true; 
} 
return false; 


上 


/ 在 手势 长 按时 触发 
public final void onLongPress(MotionEvent event) {} 


/ 在 手势 滑动 过 程 中 触发 
public final boolean onScroll(MotionEvent el, MotionEvent e2, float distanceX, float distanceY) { 
return false; 


h 


/ 在 已 按 下 但 还 未 滑动 或 松 开 时 触发 
public final void onShowPress(MotionEvent event) {} 


/ 在 轻 点 弹 起 时 触发 ， 也 就 是 点 击 时 触发 

public boolean onSingleTapUp(MotionEvent event) { 
// 获得 正在 播放 的 场景 位 置 
int position = mFlipper.getDisplayedChild(); 
/ 触发 横幅 点 击 监听 器 的 横幅 点 击 事件 
mListener.onBannerClick(position); 
return false; 
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// 播放 下 一 个 场景 
public void startFlip() { 
mFlipper.startFlipping0; / 开始 轮 播 
mFlipper.showNext(); / 显示 下 一 个 场景 
} 


/ 播放 上 一 个 场景 

public void backFlipO) { 
mFlipper.startFlipping0; / 开始 轮 播 
mFlipper.showPrevious(); / 显示 上 一 个 场景 


private Handler mHandler = new Handler0; / 声明 一 个 处 理 器 对 象 
/ 定义 一 个 指示 器 的 刷新 任务 
private Runnable mRefresh = new Runnable() { 
public void run() { 
// 获得 正在 播放 的 场景 位 置 
int pos = mFlipper.getDisplayedChild(); 
/ 根据 场景 位 置 ， 设 置 当 前 的 高 亮 指示 圆 点 
((RadioButton) mGroup.getChildAt(pos)).setChecked(true); 
/ 延迟 200 毫秒 后 再 次 启动 指示 器 刷新 任务 
mHandler.postDelayed(this, 200); 


上 


private BannerClickListener mListener; / 声明 一 个 横幅 点 击 的 监听 器 对 象 
/ 设置 横幅 点 击 监听 器 
public void setOnBannerListener(BannerClickListener listener) { 

mListener = listener; 


由 


/ 定义 一 个 横幅 点 击 的 监听 器 接口 
public interface BannerClickListener { 
void onBannerClick(int position); 
} 
} 


手势 控制 横幅 轮 播 的 效果 如 图 11-20 和 图 11-21 所 示 。 其 中 ， 如 图 11-20 所 示 为 开始 轮 播 
的 界面 ， 这 里 没有 任何 按钮 ， 完 全 依靠 手势 的 滑动 控制 左 翻 还 是 右 翻 ; 图 11-21 所 示 为 手势 从 
右 往 左 滑 过 后 的 界面 ， 从 右 往 左 滑 表示 翻 到 下 一 页 ， 记 以 当前 界面 由 第 二 页 跳 到 第 三 页 。 


了 
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图 11-20 手势 横幅 开始 轮 播 图 11-21 手势 滑动 翻 到 下 一 页 


11.4 手势 冲突 处 理 


本 节 介 绍 手势 冲突 的 三 种 常见 处 理 办 法 ， 对 于 上 下 滚动 与 左右 滑动 的 冲突 ， 既 可 由 上 级 
视图 主动 判断 是 否 拦截 , 又 可 由 下 级 视图 根据 情况 向 上 级 反馈 是 否 允 许 拦 截 ; 对 于 内 部 滑动 与 
翻 页 滑动 的 冲突 ， 加 外表 对 了 定 条 站 区 柜 攻 生 特 定 的 于 务 天 现 浊 市 同 后 各 的 区 分 站 加 对 于 正 
常 下 拉 与 下 拉 刷 新 的 冲突 ,需要 监控 当前 是 否 已 经 下 拉 到 页 面 顶 部 , 若 未 拉 到 页 面 项 部 则 为 正 

常 下 拉 ， 若 已 拉 到 页 面 项 部 则 为 下 拉 刷 新 。 
11.4.1 ”上 下 滚动 与 左右 滑动 的 冲突 处 理 

Android 控件 繁多 ， 人 允许 滚动 或 滑动 操作 的 视图 也 不 少 ， 比 如 滚动 视图 ScrollView、 翻 页 
视图 ViewPager 等 ， 如 果 开 发 者 要 自己 接管 手势 处 理 ， 像 上 一 节 手 势 控制 横幅 轮 播 那样 处 理 ， 
这 个 页 而 的 滑动 就 丰 在 重合 的 情况 ， 即 很 可 能 造成 滑动 冲突 ， 系 统 响 应 了 A 视图 的 滑动 事件 ， 
就 顾 不 上 B 视图 的 滑动 事件 。 

举 个 例子 ， 某 电 商 App 的 主页 很 长 ， 内 部 采用 滚动 视图 ScrollView， 人 允许 上 下 滚动 。 该 
页 面 中 央 有 一 个 手势 控制 的 横幅 轮 播 ， 如 图 11-22 所 示 。 用 户 在 Banner 上 左右 滑动 ， 试 图 查 
看 Banner 的 前 后 广告 ， 结 果 如 图 11-23 所 示 ， 翻 页 不 成 功 ， 整 个 页 面 反而 往 上 滚动 了 。 





招牌 惠 搬 新 家 哈 


小 积分 淘 优 惠 天 天 有 好 礼 


Qnss 


请 点 击 推介 图 片 








11-22 ”滚动 视图 中 的 横幅 轮 播 11-23 ” 翻 页 滑动 导致 上 下 滚动 
即使 多 次 重复 试验 ， 仍 然 会 发 现 Banner 很 少 跟着 翻 页 ， 而 是 继续 上 下 滚动 。 因 为 Banner 
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外 层 被 ScrollView 包 着 ， 系 统 检 测 到 用 户 手 势 的 一 撤 ， 上 级 领导 ScrollView 自作 主张 地 认为 
用 户 要 把 页 面 往 上 拉 ， 于 是 页 面 往 上 滚动 ， 完 全 没 考虑 这 一 撤 其 实 是 用 户 想 翻动 Banner。 但 
是 ScrollView 不 会 考虑 这 些 ， 因 为 没有 告诉 它 超过 多 大 斜率 才 可 以 上 下 滚动 ， 既然 没有 通知 ， 
ScrollView 只 要 发 现 手 势 事件 前 后 的 纵 坐 标 发 生变 化 ， 就 会 一 律 进行 上 下 滚动 处 理 。 

要 解决 这 个 滑动 冲突 ， 关键 在 于 提供 某 种 方式 通知 ScrollView,， 告诉 它 什么 时 候 可 以 上 下 
滚动 ,什么 时 候 不 能 上 下 滚动 。 这 个 通知 方式 主要 有 两 种 ， 一 种 是 上 级 主动 下 乡 体察 民情 ， 即 
由 滚动 视图 判断 滚动 规则 并 决定 是 否 拦截 手势 ; 另 一 种 是 下 级 向 上 反映 民意 , 即 由 下 级 视图 告 
诉 滚动 视图 是 否 拦截 手势 。 下 面 分 别 介 绍 这 两 种 处 理 方式 。 


1. 由 滚动 视图 判断 滚动 规则 


前 两 节 提 到 , 容器 类 视图 可 以 重 写 onInterceptTouchEvent 方法 , 根据 条 件 判断 结果 决定 是 
否 拦截 发 给 下 级 的 手势 。 我 们 可 以 自 定义 一 个 滚动 视图 , 在 onInterceptTouchEvent 方法 中 判断 
本 次 手势 的 横 坐 标 与 纵 坐 标 ， 如 果 纵 坐标 的 偏 移 大 于 横 坐 标的 偏 移 ， 此 时 就 是 垂直 滚动 , 应 拦 
截 手势 并 交 给 自身 进行 上 下 滚动 ; 否则 表示 此 时 为 水 平 滚动 , 不 应 拦截 手势 , 而 是 让 下 级 视图 
处 理 左 右 滑 动 事件 。 
下 面 的 代码 用 于 演示 自 定 义 滚 动 视图 拦截 垂直 滚动 、 同 时 放 过 水 平 滚动 的 功能 。 
public class CustomScrollView extends ScrollView { 
private float mOffsetX, moOffsetY;， / 横 纵 方向 上 的 偏 移 
private float mLastPosX, mLastPosY; / 上 次 落 点 的 横 纵 坐标 
private int mInterval; / 与 边缘 线 的 间距 阀 值 














public CustomScrollView(Context context AttributeSet attr) { 
Super(context attr); 
mInterval = Utils.dip2px(context, 3); 

b 


// 在 拦截 触摸 事件 时 触发 
public boolean onInterceptTouchEvent(MotionEvent event) { 
boolean result; 
switch (event.getAction()) { 
case MotionEvent.ACTION_DOWN: // 手指 按 下 
mOffsetX = 0.0F; 
mOffsetY = 0.0F; 
mLastPosX = event.getX(); 
mLastPosY = event.getY(); 
Tesult = super.onInterceptTouchEvent(event); 
break; 
default: // 其 余 动作 ， 包 括 手指 移动 、 手 指 松 开 等 等 
float thisPosX = event.getX(); 
float thisPosY = event.getY(); 
mOffsetX += Math.abs(thisPosX - mLastPosX); /x 轴 偏 差 
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moOffsetY += Math.abs(thisPosY - mLastPosY); /y 轴 偏 差 
mLastPosX =thisPosX; 
mLastPosY = thisPosY; 
if (mOffsetX < mInterval && mOffsetY < mInterval) { 

result= false; // 鱼 lse 传 给 表示 子 控件 ， 此 时 为 点 击 事件 
} else if (mOffsetX < mOffsetY) { 

result= tme; // true 表示 不 传 给 子 控件 ， 此 时 为 垂直 滑动 
}else{ 

result= false; /false 表示 传 给 子 控件 ， 此 时 为 水 平滑 动 


接着 在 XML 布局 文件 中 把 ScrollView 节点 改 
为 自 定义 深 动 视图 的 完整 路 径 名 称 ( 如 
com.example.event.widget.CustomScrollView) ， 重 
新 运行 App 后 查看 横幅 轮 播 ， 手 势 滑 动 效 果 如 图 
11-24 所 示 。 此 时 翻 页 成 功 , 且 整 个 页 面 固定 不 动 ， 
未 发 生 上 下 滚动 的 情 ; 


2. 下 级 视图 告诉 滚动 视图 能 否 拦截 手势 


目前 的 案例 中 ，ScrollView 下 面具 有 Banner 
-个 淘气 鬼 ， 所 以 允许 单独 给 它 开 小 灶 。 在 实际 场 图 11-24 翻 页 滑动 未 造成 上 下 滚动 
合 中 ， 往 往 有 多 个 调皮 鬼 ， 一 个 要 吃 苹果 ， 另 一 个 要 吃香 花 ， 倘 若 都 要 ScrollView 帮忙 ， 那 
可 真是 众 口 难 调 ， 忙 都 忙 不 过 来 了 。 不 如 弄 个 水 果 笑 ,让 这 些小 屁 孩 自己 去 拿 ， 要 吃 苹果 的 就 
拿 苹 果 ， 要 吃香 蒋 的 就 拿 香 兢 ， 如 此 皆大欢喜 ， 再 也 不 用 大 人 劳 心 劳力 了 。 
具体 到 代码 的 实现 , 是 调用 requestDisallowInterceptTouchEvent 方法 , 该 方法 的 参数 为 true 
时 , 表示 禁止 上 级 拦截 触摸 事件 。 至 于 何 时 调用 该 方法 ， 当 然 是 在 检测 到 滑动 前 后 的 横 坐 标 偏 
移 大 于 纵 坐 标 偏 移 了 。 对 于 Banner 采用 手势 监听 器 的 情况 ， 可 重 写 监 听 器 的 onScroll 方法 ， 
在 该 方法 中 加 入 坐标 偏 移 的 判断 ， 代 码 如 下 : 
/ 在 手势 滑动 过 程 中 触发 
public final boolean onScroll(MotionEvent el, MotionEvent e2, float distanceX, float distanceY) { 
/ 如 果 外 层 是 普通 的 ScrollView， 则 此 处 不 允许 父 容 器 的 拦截 动作 
// CustomScrollActivity 里 面 通过 自 定义 ScrollView， 来 区 分 水 平滑 动 还 是 垂直 滑动 
/BannerOptimizeActivity 使 用 系统 ScrollView， 则 此 处 需要 下 面 代 码 禁 止 父 容器 的 拦截 
让 (Math.abs(distanceY) < Math.abs(distanceX)) { // 水 平方 向 的 滚动 
/ 告诉 上 级 布局 不 要 拦截 触摸 事件 
BannerFlipper.this.getParent().requestDisallowInterceptTouchEvent(true); 
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return true; // 返回 true 表示 要 继续 处 理 
} else {// 垂直 方向 的 滚动 
return false; / 返回 false 表示 不 处 理 了 
} 
} 


修改 后 的 手势 滑动 效果 如 图 11-24 所 示 。 左右 滑动 能 够 正常 翻 页 ， 整个 页 面 也 不 容易 上 下 
滚动 了 。 


11.4.2 ”内 部 滑动 与 翻 页 滑动 的 冲突 处 理 


在 前 面 的 手势 冲突 中 ，ScrollView 是 上 级 视图 ， 有 时 也 是 下 级 视图 ， 比 如 页 面 采 用 
ViewPager 布局 ， 每 个 Fragment 之 间 是 左右 滑动 的 关系 ， 每 个 Fragment 都 可 以 拥有 自己 的 
ScrollView。 如 此 一 来 ， 在 左右 滑动 时 ，ScrollView 反而 变 成 ViewPager 的 下 级 ， 这 样 前 面 的 
冲突 处 理 办 法 不 能 奏效 了 ， 只 能 男 想 办 法 。 

自 定义 一 个 基于 ViewPager 的 翻 页 视图 是 一 种 思路 ; 另 一 种 思路 可 借鉴 Android 自 带 的 抽 
导 布 局 DrawerLayout， 该 布局 视图 允许 左右 滑动 ， 在 滑动 时 会 拉 出 侧面 的 抽 屋 面板， 常用 于 
实现 侧 滑 菜单 。 抽 居 布 局 与 翻 页 视图 在 滑动 方面 有 区 别 , 翻 页 视图 在 内 部 的 任何 位 置 均 可 触发 
滑动 事件 ， 而 抽 居 布局 只 在 屏幕 两 侧 边 缘 才 会 触发 滑动 事件 。 

举 个 实际 应 用 的 例子 ， 微 信 的 聊天 窗口 是 上 下 深 动 的 ， 在 主 窗口 的 大 部 分 区 域 触摸 都 是 
上 下 滚动 窗口 , 若 在 窗口 左 侧 边 缘 按 下 再 右 拉 ， 则 可 看 到 左边 拉 出 了 消息 关注 页 面 。 限 定 某 块 
区 域 接管 特定 的 手势 是 处 理 滑 动 冲突 的 另 一 种 行 之 有 效 的 方法 。 

既然 提 到 了 抽 居 布局 ， 不 妨 稍 微 了 解 一 下 。 下 面 是 DrawerLayout 的 常用 方法 说 明 。 


e@ setDrawerShadow: 设置 主页 面 的 渐变 阴影 图 形 。 
e@ addDrawerListener: 添加 抽 尾 面板 的 拉 出 监听 器 。 需 实现 监听 器 DrawerListener 的 4 个 方 
法 : 


> onDrawerSlide: 抽 层 面板 滑动 时 触发 。 

> onDrawerOpened: 抽 层 面板 打开 时 触发 。 

> onDrawerClosed: 抽 层 面板 关闭 时 触发 。 

> onDrawerStateChanged: 抽 层 面板 的 状态 发 生变 化 时 触发 。 


removeDrawerListener: 移 除 抽 屋 面板 的 拉 出 监听 器 。 
closeDrawers: 关闭 所 有 抽 居 面板 。 

openDrawer: 打开 指定 抽 层 面板 。 

closeDrawer: 关闭 指定 抽 居 面板 。 

isDrawerOpen: 判断 指定 抽 导 面板 是 否 打开 。 


抽 屠 布局 不 但 可 以 拉 出 左 侧 抽 居 面板， 而 且 可 以 拉 出 右 侧 抽 导 面板 。 左 侧面 板 与 右 侧面 
板 的 区 别 在 于 : 左 侧面 板 在 布局 文件 中 的 layout_gravity 属性 为 left, 而 右 侧 面板 在 布局 文件 中 
的 layout_gravity 属性 为 right。 
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下 面 是 使 用 DrawerLayonut 的 布局 文件 : 


<android.support.v4.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/dl_ layout" 
android:layout_width="match parent" 
android:layout_height="match_parent" > 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" > 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:orientation="horizontal" > 


<Button 
android:id="(@+id/btn_drawer_left" 
android:layout_width="0dp" 
android:layout_height="wrap_content" 
android:layout_weight="1" 
android:gravity="center" 


android:text=" 打 开 左 边 侧 滑 " /> 


<Button 

android:id="@+id/btn_drawer right" 
android:layout_ width="0dp” 
android:layout_height="wrap_content" 
android:layout_weight="1" 
android:gravity="center" 
android:text=" 打 开 右 边 侧 滑 " /> 

</LinearLayout> 


<TextView 
android:id="(@+id/ty_drawer_center" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="1" 
android:gravity="toplcenter" 
android:padding Top="30dp" 
android:text=" 这 里 是 首页 " /> 
</LinearLayout> 
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<!-- 这 是 位 于 抽 层 布局 左边 的 侧 滑 列表 视图 ，layout_gravity 属性 设 定 了 它 的 对 齐 方式 --> 
<ListView 

android:id="(@+id/lv_drawer left" 

android:layout_width="150dp" 

android:layout_height="match_parent" 

android:layout gravity="left" 

android:background="#ffdd99" /> 


<!-- 这 是 位 于 抽 层 布局 右边 的 侧 滑 列表 视图 ，layout_gravity 属性 设 定 了 它 的 对 齐 方式 -> 
<ListView 
android:id="(@+id/lv_drawer right" 
android:layout_width="150dp" 
android:layout_height="match_parent" 
android:layout_ gravity="right" 
android:background="#99ffdd" /> 
</android.support.v4.widget.DrawerLayout> 


上 述 布 局 文件 对 应 的 页 面 代码 如 下 : 


public class DrawerLayoutActivity extends AppCompatActivity implements OnClickListener { 
private DrawerLayout dl_layout; / 声明 一 个 抽 居 布局 对 象 
private Button btn_drawer_left; 
private Button btn_drawer_right; 
private TextView tv_drawer_center; 
private ListView lv_drawer_left; / 声明 左 侧 菜单 的 列表 视图 对 象 
private ListView lv_drawer right; / 声明 右 侧 菜 单 的 列表 视图 对 象 
private String[] titleArray = {" 首 页 ", "新 闻 ", "娱乐 " "博客 ", "论坛 "};，// 左 侧 菜单 项 的 标题 数组 
private String[] settingArray = {" 我 的 ", "设置 ", "关于 "};”// 右 侧 菜 单项 的 标题 数组 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_drawer_layout); 
1/ 从 布局 文件 中 获取 名 叫 dl_layout 的 抽 层 布局 
dl_layout = findViewById(R.id.dl_layout); 
/ 给 抽 层 布局 设置 侧 滑 监 听 器 
dl_layout.addDrawerListener(new SlidingListener()); 
btn_drawer left = findViewById(R.id.btn_drawer lefb; 
btn_drawer right = findViewById(R.id.btn_drawer right); 
tv_drawer_center = find ViewById(R.id.tv_drawer_center); 
btn_drawer left.setOnClickListener(this); 
btn_drawer right.setOnClickListener(this); 
initListDrawer(); / 初始 化 侧 滑 的 菜单 列表 
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/ 初始 化 侧 滑 的 菜单 列表 
private void initListDrawer() { 
/ 下 面 初始 化 左 侧 菜单 的 列表 视图 
lv_drawer left = findViewById(R.id.IV_drawer lefb; 
ArrayAdapter<String> left adapter = new ArrayAdapter<String>(this, 
R.layout.item select, titleArray); 
lv_drawer left.setAdapter(left adapter); 
lv_drawer left.setOnItemClickListener(new LeftListListener()); 
// 下 面 初始 化 右 侧 菜单 的 列表 视图 
lv_drawer right = findViewById(R.id.lv_drawer right); 
ArrayAdapter<String> right adapter = new ArrayAdapter<String>(this, 
R.layout.item select, settingArray); 
lv_drawer right.setAdapter(right_adapten); 
lv_drawer right.setOnItemClickListenernew RightListListener()); 


public void onClick(View v) { 
if (v.getld() 一 R.id.btn_drawer left) { 
这 (dl_layout.isDrawerOpen(lv_drawer_left)) { // 左 侧 菜 单列 表 已 打开 
dl_layout.closeDrawer(lv_drawer_left); // 关闭 左 侧 抽 层 
} else { // 左 侧 菜单 列表 未 打开 
dl_layout.openDrawer(lv_drawer_left); / 打开 左 侧 抽 层 
} 
} else if (v.getId() 一 R.id.btn_drawer right) { 
让 (dl_layoutisDrawerOpen(lv_drawer_right)) { // 右 侧 菜单 列表 已 打开 
dl_layout.closeDrawer(lv_drawer_right); / 关闭 右 侧 抽 层 
} else { // 右 侧 菜单 列表 未 打开 
dl_layout.openDrawer(lv_drawer_right);// 打开 右 侧 抽 层 


} 


// 定义 一 个 左 侧 菜单 列表 的 点 击 监听 器 
private class LeftListListener implements OnItemClickListener { 
public void onItemClick(AdapterView<?> parent, View view, int position, long id) { 
String text = titleArray[position]; 
tv_drawer_center.setText(" 这 里 是 " + text+ "页 面 "); 
dl_layout.closeDrawers(); // 关闭 所 有 抽 层 


) 


/ 定义 一 个 右 侧 菜单 列表 的 点 击 监听 器 
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Private class RightListListener implements OnItemClickListener { 
public void onItemClick(AdapterView<?> parent, View view, int position, long id) { 
String text = settingArray[position]; 
tv_drawer centersetText(" 这 里 是 " + text+ "页 面 "); 
dl_layout.closeDrawers(); / 关闭 所 有 抽 层 


b 


// 定义 一 个 抽 层 布局 的 侧 滑 监听 器 
private class SlidingListener implements DrawerL istener { 
/ 在 拉 出 抽 层 的 过 程 中 触发 
public void onDrawerSlide(View drawerView. float slideOffset) {} 


/ 在 侧 滑 抽 导 打开 后 触发 
public void onDrawerOpened(View drawerView) { 
让 (drawerView.getId0 一 R.id.lv_drawer left) { 
btn_drawer_left.setText(" 关 闭 左边 侧 滑 "); 
}else { 
btn_drawer_right.setText(" 关 闭 右 边 侧 滑 "); 


} 


/ 在 侧 滑 抽 屠 关闭 后 触发 
public void onDrawerClosed(View drawerView) { 
if (drawerView.getld() 一 R.id.lv_drawer_left) { 
btn_drawer_left.setText(" 打 开 左 边 侧 滑 "); 
} else { 
btn_drawer_right.setText(" 打 开 右 边 侧 滑 "); 
} 
} 


/ 在 侧 滑 状态 变更 时 触发 
public void onDrawerStateChanged(int paramInt) {} 


} 


抽 居 布局 的 展示 效果 如 图 11-25、 图 11-26、 图 11-27 
所 示 。 其 中 ， 图 11-25 所 示 为 初始 页 面 ， 图 11-26 所 示 








为 在 左 侧 边缘 拉 出 左边 侧 滑 菜单 的 界面 , 图 11-27 所 示 i 打开 右边 侧 滑 
为 在 右 侧 边缘 拉 出 右边 侧 滑 菜 单 的 界面 。 Sn 





11-25 ”演示 抽 届 布局 的 初始 界面 
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11-26 左 侧 边缘 拉 出 侧 滑 菜 单 图 11-27 右 侧 边缘 拉 出 侧 滑 菜单 


11.4.3 ”正常 下 拉 与 下 拉 刷 新 的 冲突 处 理 


第 7 章 的 “7.3.3 仿 京东 项 到 状态 栏 的 Banner” 介 绍 了 高 仿 京 东 的 沉浸 式 状 态 栏 ， 可 是 跟 
京东 首页 的 头 部 轮 播 图 相 比 ， 依 然 有 3 处 缺憾 : 

(1) 京东 的 头 部 Banner 上 方 , 除了 有 悬浮 着 的 状态 栏 , 状态 栏 下 面 还 有 一 行 悬浮 工具 栏 ， 
内 桥 扫 一 扫 图 标 、 搜 索 框 及 消息 图 标 。 

(2) 把 整个 页 面 往 上 拉 ， 状 态 栏 的 背景 色 从 透明 变 为 深 灰 ， 同 时 工具 栏 的 背景 也 从 透明 
变 为 白色 。 

(3) 页 面 下 拉 到 项 后 ， 继 续 下 拉 会 拉 出 带 有 “下 拉 刷 新 ”字样 的 布局 ， 此 时 松手 则 会 触 
发 页 面 的 刷新 动作 。 

上 面 第 一 点 的 状态 栏 和 工具 栏 悬 浮 效果 ， 都 有 对 应 的 解决 办 法 ; 第 二 点 的 状态 栏 和 工具 


栏 背景 变更 ， 也 存在 可 行 的 解决 方案 。 倒 是 第 三 点 的 下 拉 刷 新 ， 以 及 第 二 点 的 上 拉 监 听 ， 却 不 
容易 实现 。 


虽然 Android 提供 了 专门 的 下 拉 刷 新 布局 SwipeRefreshLayout， 但 它 并 没有 页 面 随手 势 下 
滚 的 效果 。 一 些 第 三 方 的 开源 库 如 PullToRefresh、SmartRefreshLayout 固然 能 让 整体 页 面 下 滑 ， 
可 是 项 部 的 下 拉 布 局 很 难 个 性 化 定制 ， 至 于 状态 栏 、 工 具 栏 的 背景 色 修 改 更 是 三 不 管 。 因 此 若 
想 呈 现 完全 仿照 京东 的 下 拉 刷 新 特效 ， 只 能 由 开发 者 编写 一 个 自 定义 的 布局 控件 了 。 

自 定义 的 下 拉 刷 新 布局 ， 首 先 要 能 够 区 分 是 页 面 的 正常 下 滚 ， 还 是 拉 伸 头 部 要 求 刷新 。 
二 者 之 间 的 区 别 很 简单 ,直觉 上 看 就 是 判断 当前 页 面 是 否 拉 到 项 了 。 倘 若 还 没 拉 到 项 ， 继 续 下 
拉动 作 属 于 正常 的 页 面 滚动 ; 倘若 已 经 拉 到 项 了 ， 继 续 下 拉动 作 才 会 拉 出 头 部 提示 刷新 。 所 以 
此 处 得 捕捉 页 面 滚动 到 顶部 的 事件 ， 相 对 应 的 则 是 页 面 滚动 到 底部 的 事件 。 鉴 于 App 首页 基 
本 采用 滚动 视图 ScrollView 实现 页 面 滚动 功能 ， 故 而 该 问题 就 变 成 了 如 何 监听 该 视图 滚 到 项 
部 或 者 滚 到 底部 。 正 好 ScrollView 提供 了 滚动 行为 的 变化 方法 onScrollChanged， 通 过 重 写 该 
方法 即 可 判断 是 否 到 达 顶 部 或 底部 ， 重 写 后 的 代码 片段 如 下 所 示 : 

// 在 滚动 变更 时 触发 

protected void onScrollChanged(int L intt int oldl int oldb { 
super.onScrollChanged(], t, oldl, oldt); 
boolean isScrolledToTop; 
boolean isScrolledToBottom:; 
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这 (getScrollY() 一 0) { / 下 拉 滚 动 到 顶部 
isScrolledToTop = true; 
isScrolledToBottom = false; 
} else if (getScrollY() + getHeight() - getPaddingTop() - getPaddingBottom() 
二 getChildAt(0).getHeight0)) { / 上 拉 滚 动 到 底部 
isScrolledToBottom = true; 
isScrolledToTop = false; 
} else { // 未 拉 到 顶部 ， 也 未 拉 到 底部 
isScrolledToTop = false; 
isScrolledToBottom = false; 
} 
if (mScrollListener !{= null) { 
if(isScrolledToTop) { / 已 经 滚动 到 顶部 
/ 触发 下 拉 到 项 部 的 事件 
msScrollListeneronScrolledToTop0; 
} else if(isScrolledToBottom){ / 已 经 滚动 到 底部 
/ 触发 上 拉 到 底部 的 事件 
mScrollListener.onScrolledToBottom(); 


} 


private ScrollListener mScrollListener; / 声明 一 个 滚动 监听 器 对 象 
/ 设置 滚动 监听 器 
public void setScrollListener(ScrollListener listener) { 

mScrollListener = listener; 


) 


// 定义 一 个 滚动 监听 器 接口 ， 用 于 捕捉 到 达 顶 部 和 到 达 底部 的 事件 
public interface ScrollListener { 

void onScrolledToBottom0; / 已 经 滚动 到 底部 

void onSerolledToTop0; / 已 经 滚动 到 顶部 
} 


如 此 改造 一 番 , 只 要 页 面 Activity 设置 滚动 视图 的 滚动 监听 器 , 就 能 经 


由 onScrolledToTop 


方法 判断 当前 页 面 是 否 拉 到 项 了 。 既然 可 以 知晓 到 顶 与 否 , 同步 变更 状态 栏 和 工具 栏 的 背景 色 
也 是 可 行 的 了 。 演 示 页 面 拉 到 顶部 附近 的 两 种 效果 如 图 11-28 和 图 11-29 所 示 ， 其 中 图 11-28 
为 上 拉 页 面 使 之 整体 上 滑 ， 此 时 状态 栏 的 背景 变 灰 、 工 具 栏 的 背景 变 白 ; 图 11-29 为 下 拉 页 面 





使 之 接近 顶部 ， 此 时 状态 栏 和 工具 栏 的 背景 均 恢复 透明 。 


然而 成 功 监听 页 面 是 否 到 达 顶 部 或 底部 ， 仅 仅 解决 了 状态 栏 和 工具 栏 的 变色 问题 。 因 为 
页 面 到 顶 后 继续 下 拉 ， 此 时 ScrollView 要 怎么 处 理 ? 一 方面 是 整个 页 面 已 经 拉 到 项 了 ， 造 成 
ScrollView 已 经 无 可 再 拉 ; 另 一 方面 ， 用 户 在 京东 首页 看 到 的 下 拉 头 部 ， 其 实 并 不 属于 
ScrollView 管辖 ， 即 使 ScrollView 想 拉 这 个 头 部 兄弟 一 把 ， 也 只 能 有 心 无 力 。 不 管 ScrollView 
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是 惊慌 失措 ， 还 是 不 知 所 措 ， 恰 恰 说 明 它 是 真正 的 束手无策 了 , 为 此 还 要 一 个 和 事 化 来 摆平 下 
拉 布 局 和 滚动 视图 之 间 的 纠纷 。 





1 0 
® S09 


请 反复 下 拉 页 面 和 上 拉 页 面 


请 反复 下 拉 页 面 和 上 拉 页 面 





图 11-28 上 拉 页 面 时 的 导航 栏 图 11-29 下 拉 页 面 时 的 导航 栏 


这 个 和 事 佬 必须 是 下 拉 布 局 和 滚动 视图 的 上 级 布局 ， 考 虑 到 下 拉 布局 在 上 ， 而 滚动 视图 
在 下 ， 故 它 俩 的 上 级 布局 继承 线性 布局 LinearLayout 比较 合适 。 新 的 上 层 视图 需要 完成 以 下 3 
项 任务 : 


(1) 在 下 层 视图 的 最 前 面 自动 添加 一 个 下 拉 刷 新 头 部 ， 保 证 该 下 拉 头 部 位 于 整个 页 面 的 
最 上 方 。 

(2) 给 前 面 自 定义 的 滚动 视图 注册 滚动 监听 器 和 触摸 监听 器 ， 其 中 滚动 监听 器 用 于 处 理 
到 达 顶 部 /底部 的 事件 ， 触 摸 监听 器 用 于 处 理 下 拉 过 程 中 的 持续 位 移 。 

(3) 重 写 触摸 监听 器 接口 需要 实现 的 onTouch 函数 ， 这 个 是 重 中 之 重 ， 因 为 该 函数 包含 
了 所 有 的 手势 下 拉 跟 踪 处 理 。 既 要 准确 响应 正常 的 下 拉手 势 , 也 要 避免 误 操作 不 属于 下 拉 的 手 
势 ， 比 如 下 面 几 种 情况 就 得 统筹 考虑 : 

@ 水 平方 向 的 左右 滑动 ， 不 做 额外 处 理 。 

@ 垂直 方向 的 向 上 拉动 ， 不 做 额外 处 理 。 

@ 下 拉 的 时 候 ， 如 果 尚 未 拉 到 页 面 顶 部 ， 也 不 做 额外 处 理 。 

@ 拉 到 顶 之 后 继续 下 拉 ， 则 隐藏 工具 栏 的 同时 ， 还 要 让 下 拉 头 部 跟着 往 下 滑动 。 

@ 下 拉 刷 新 过 程 中 松 开 手势 ， 判 断 下 拉 滚动 的 距离 ， 距 离 太 短 则 直接 缩 回头 部 、 不 进行 
页 面 刷新 ， 只 有 距离 足够 长 ， 才 能 触发 页 面 刷新 动作 ， 等 待 刷新 完毕 再 缩 回 头 部 。 


现在 有 了 新 定义 的 下 拉 上 层 布 局 ， 搭 配 自 定义 的 滚动 视图 ， 就 能 很 方便 地 实现 高 仿 京 东 
首页 的 下 拉 刷 新 效果 了 。 具 体 实现 的 首页 布局 模板 如 下 所 示 : 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="(@color/white"> 





<!-- PullDownRefreshLayout 是 自 定义 的 下 拉 上 层 布局 --> 

<com.example.event.widget.PullDownRefreshLayout 
android:id="@+tid/pdrl_main" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
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android:orientation= "vertical"> 


<!-- PullDownScrollView 是 自 定义 的 滚动 视图 --> 

<com.example.event.widget.PullDownScrollView 
android:id="(@+id/pdsv_main" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:orientation= "vertical"> 


<!-- 此 处 放 具 体 页 面 的 布局 内 容 --> 
</LinearLayout> 
</com.example.event.widget.PullDownScrollView> 
</com.example.event.widget.PullDownRefreshLayout> 


<!-- title_drag.xml 是 带 搜索 框 的 工具 栏 布局 --> 
<include layout="(@layouttitle_drag" /> 
</RelativeLayout> 


以 上 布局 模板 用 到 的 自 定义 控件 PullDownRefreshLayout 和 PullDownScrollView， 因 为 代 
码 量 较 多 ， 这 里 就 不 贴 出 来 ， 读 者 可 参考 本 书 附带 源码 event 模块 的 相关 源码 。 运 行 改造 后 的 
测试 App， 下 拉 刷 新 的 效果 如 图 11-30 和 图 11-31 所 示 ， 其 中 图 11-30 为 正在 下 拉 时 的 截图 ， 


图 11-31 为 松 开 下 拉 、 开 始 刷新 时 的 截图 。 


博 完好 礼 等 你 玉 
1 峰村 


请 反复 下 拉 页 面 和 上 拉 页 面 





正在 努力 刷新 页 面 





图 11-30 ”正在 下 拉 时 的 页 面 图 11-31 松 开 刷新 时 的 页 面 





是 下 日 11:11 
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11.5 “实战 项 目 : 抠 图 神器 一 一 美 图 变 变 


程序 员 通 常 是 闽 骚 的 宅男 ， 对 技术 的 钻研 孜孜 不 倦 ， 不 过 一 味 地 追求 技术 深度 ， 不 见得 
就 能 登 上 襄 峰 。 壁 如 智能 手机 行业 ,以 技术 制胜 的 华为 和 小 米 , 也 要 不 耻 下 间 向 OPPO 和 vivo 
学 习 。 究 其 原因 ， 多半 是 后 者 认真 对 待 用 户 需求 ， 从 用 户 体验 的 痛 点 下 手 ， 推 出 了 自拍 美 颜 等 
手机 ， 由 此 收获 了 大 批 客户 。 本 节 的 实战 项 目 不 求 技术 有 多 广 、 多 深 ， 只 求 有 没有 用 、 好 不 好 
用 。 所 谓 抠 图 神器 ,就 是 从 一 幅 图 片 中 抠 出 用 户 想 要 的 某 块 区 域 。 就 像 在 花 店 里 卖 花 ， 先 适当 
修剪 花束 ， 再 配 上 一 些 包 装 ， 顿 时 看 起 来 美美 蚊 ， 不 愁 用 户 不 喜欢 。 


11.5.1 设计 思 





这 里 说 的 美 图 变 变 ， 其 实 就 是 一 个 抠 图 工具 ， 通 过 对 图 像 进行 平 移 、 缩 放 、 旋 转 等 操作 ， 
把 图 像 的 某 个 区 域 抠 下 来 。 如 图 11-32 所 示 为 美 图 变 变 的 效果 图 ， 中 间 高 亮 部 分 为 待 抠 区 域 ， 
西湖 后 面 的 雷 峰 塔 太 小 了 ， 现 在 准备 把 雷 峰 塔 先 拉 近 再 放大 ， 
然后 抠 出 来 。 

这 个 效果 图 的 界面 很 简洁 ， 主 界面 没有 任何 控制 按钮 ， 
完全 靠 手势 操作 。 实 现 的 手势 处 理 有 以 下 6 种 。 


。 长 按 手势 : 在 页 面 任何 一 处 长 按 0.5 秒 以 上 ， 即 可 能 发 
长 按 事件 ， 弹 出 文件 菜单 后 选择 打开 图 片 或 保存 图 片 。 

。 移动 高 这 区 域 的 手势: 点 击 高 这 区 域内 部 ,再 滑动 手势， 
即 可 将 该 区 域 卸 名 至 指定 位 置 

。 调整 高 训 区 域 边界 的 手势 : 点 击 高 亮 区 域 边界 ,再 滑动 
手势 ， 即 可 将 边界 拉 至 指定 位 置 ， 

。 移动 图 片 的 手势 : 点 击 高 这 区 域外 部 (阴影 部 分 ) ， 然 
后 滑动 手势 ， 即 可 将 整 张 图片 拖 风 至 指定 位 置 。 

。 缩放 图 片 的 手势 : 两 只 手指 同时 按压 屏幕 ,然后 一 起 往 
中 心 点 接近 或 远离， 即 可 实现 图 片 的 缩小 和 放大 操作 。 

。 旋转 图 片 的 手势 : 两 只 手指 同时 按压 屏幕 ,然后 围绕 中 。 图 11 32 美国 变 刘 的 报国 效果 
心 点 一 起 顺 时 针 或 送 时 针 转 动 ， 即 可 实现 图 片 的 旋转 操 
作 . 


长 按 和 移动 手势 的 判断 相对 简单 ,根据 按压 时 长 或 按压 坐标 就 能 判断 属于 哪 类 手势 。 缩放 与 
旋转 手势 的 判断 相对 复杂 ,涉及 多 点 触 控 和 三 角 函 数 相关 知识 ， 主 要 思路 是 : 记录 两 只 手指 移动 
前 的 坐标 和 移动 后 的 坐标 , 总 共 4 个 坐标 点 , 然后 分 别 计算 移动 前 的 两 指 距离 和 移动 后 的 两 指 距 
离 ， 判 断 两 个 距离 的 差 是 否 大 于 两 指 移动 距离 之 和 的 二 分 之 根 号 二 倍 。 判 断 结果 若是 大 于 ， 则 表 
示 本 次 为 缩放 手势 ， 否 则 为 旋转 手势 ， 接 着 计算 缩放 比例 或 旋转 角度 即 可 。 缩 放 与 旋转 手势 的 直 
观 判 定 方式 如 图 11-33 所 示 ， 假 设 两 根 手 指 的 初始 落 点 方向 为 右上 角 ， 则 后 续 移动 的 左下 角 与 右 


event 
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上 角 范 围 为 缩放 区 域 ， 而 左上 角 和 右 下 角 范 围 为 旋转 区 域 。 





旋转 区 域 “| 缩放 区 域 


初始 访 向 











图 11-33 ”缩放 手势 与 旋转 手势 的 区 域 判定 
11.5.2 “小 知识 : 二 维 图 像 的 基本 加 工 


Android 上 的 图 形 使 用 Drawable 类 ， 位 图 管理 使 用 Bitmap 类 。Drawable 用 于 在 界面 上 展 
示 图 片 ，Bitmap 用 于 对 图 像 数 据 进行 加 工 操 作 ， 图 像 加 工 操作 包括 平移 、 缩 放 、 旋 转 、 裁 前 
等 。 这 两 个 类 之 间 的 转换 通过 BitmapDrawable 完成 。 

其 中 ，Bitmap 转 Drawable 的 代码 如 下 : 


/ 把 位 图 对 象 转换 为 图 形 对 象 
Drawable drawable = new BitmapDrawable(getResources(), bitmap); 


Drawable 转 Bitmap 的 代码 如 下 : 


/ 把 图 形 对 象 转换 为 位 图 对 象 
Bitmap bitmap = ((BitmapDrawable)drawable).getBitmap(); 


下 面 是 Bitmap 的 常用 方法 说 明 。 


createBitmap: 从 源 图 像 中 裁剪 一 块 位 图 区 域 。 

createScaledBitmap: 根据 设 定 的 图 片 大 小 从 源 图 像 获 得 缩放 后 的 新 图 像 。 
compress: 根据 设 定 的 位 图 格式 与 压缩 质量 对 图 像 进行 压缩。 

recycle: 回收 位 图 对 象 资源 。 

getByteCount: 获取 位 图 对 象 的 字 节 大 小 。 

getWidth: 获取 位 图 对 象 的 宽度 。 

getHeight: 获取 位 图 对 象 的 高 度 。 


了 解 这 些 方法 的 使 用 说 明 后 ， 就 可 以 实现 图 像 的 基本 加 工 操作 了 。 


(1) 图 像 裁剪 : 调用 Bitmap 类 的 createBitmap 方法 时 ， 指 定 裁 前 图 像 的 上 、 下 、 左 、 右 
边界 即 可 。 

(2) 图 像 平 移 : 调用 Canvas 对 象 的 drawBitmap 时 ， 指 定 图 像 绘制 的 起 始点 位 置 即 可 。 

(3) 图 像 缩 放 : 调用 Bitmap 类 的 createScaledBitmap 方法 时 ， 指 定 新 图 像 的 宽 高 即 可 。 

(4) 图 像 旋 转 : 需要 借助 矩阵 工具 Matrix， 先 调用 Matrix 对 象 的 postRotate 方法 设置 旋 
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转角 度 ， 再 根据 设置 好 的 矩阵 对 象 调用 createBitmap 方法 创建 旋转 图 像 ， 转 换代 码 如 下 : 


/ 获得 旋转 角度 之 后 的 位 图 对 象 
public static Bitmap getRotateBitmap(Bitmap b, float rotateDegree) { 
/ 创建 操作 图 片 用 的 矩阵 对 象 
Matrix matrix = new Matrix(); 
/ 执行 图 片 的 旋转 动作 
matrix.postRotate(rotateDegree); 
/ 创建 并 返回 旋转 后 的 位 图 对 象 
return Bitmap.createBitmap(b, 0, 0, b.getWidth(), 
b.getHeight(), matrix, false); 
| 
图 像 变 换 的 效果 如 图 11-34、 图 11-35、 图 11-36 所 示 。 其 中 ， 如 图 11-34 所 示 为 原始 的 图 
像 界面 ， 如 图 11-35 所 示 为 放大 两 倍 后 的 图 像 界面 ， 如 图 11-36 所 示 为 顺 时 针 旋 转 90 度 后 的 图 
像 界面 。 





打开 图 片 文件 保存 图 片 文件 打开 图 片 文件 


缩放 比率 :1.0 “旋转 角度 0 ~ : : 区 缩放 比率 ;: 1.0 











图 11-34 变换 前 的 原始 图 像 图 11-35 ”放大 两 倍 后 的 图 像 图 11-36 旋转 90 度 后 的 图 像 


11.5.3 ”代码 示例 


(1) 对 图 片 文件 进行 打开 和 保存 操作 , 记得 为 AndroidManifest.xml 添加 对 应 的 权限 配置 。 
<!--SD 卡 -> 
<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE'" /> 
<uses-permission android:name="android.permission.MOUNT_UNMOUNT _ FILESYSTEMS" /> 


(2) 长 按 弹出 文件 菜单 ， 需 要 在 res/menu 目录 下 添加 菜单 布局 文件 menu_meitu.xml。 
(3) 要 在 真 机 上 测试 实战 项 目 ， 因 为 模拟 器 不 支持 多 点 触 控 ， 只 有 真 机 才能 测试 手势 的 
缩放 与 旋转 操作 。 
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测试 时 ， 首 先 在 实战 项 目的 界面 上 长 按 ， 弹 出 读 取 图 片 文件 的 菜单 ， 如 图 11-37 所 示 。 


打开 图 片 


保存 图 片 





图 11-37 长 按 主页 面 弹出 读 写 图 片 文件 的 菜单 


点 击 “ 打 开 图 片 ”， 打 开 待 加 工 的 图 片 文 件 ， 拖 动 原始 图 片 与 高 亮 区 域 ， 并 适当 放大 与 
旋转 图 片 , 使 雷 峰 塔 位 于 高 亮 区 域 中 上 部 。 期 间 的 界面 效果 如 图 11-38 与 图 11-39 所 示 。 其 中 ， 
如 图 11-38 所 示 为 刚 打 开 图 片 时 的 初始 界面 ， 如 图 11-39 所 示 为 手势 调整 结束 ,准备 完成 抠 图 
时 的 界面 。 

接 下 来 保存 抠 图 完成 的 图 片 , 在 界面 上 长 按 , 弹出 读 取 图 片 文件 的 菜单 , 如 图 11-40 所 示 。 


























图 11-38 ” 抠 图 开始 前 的 界面 图 11-39 抠 图 完成 后 的 界面 。 图 11-40 长 按 主页 面 准备 保存 抠 图 





点 击 “保存 图 片 ”， 填 写 保存 后 的 文件 名 ， 完 成 图 片 保存 操作 ， 即 可 在 指定 的 路 径 找到 

抠 下 来 的 图 片 。 
下 面 是 自 定义 抠 图 视图 中 关于 缩放 与 旋转 手势 的 判断 代码 示例 ， 完 整 代码 参见 本 书 附 带 

源码 event 模块 的 MeituView.java: 

// 当前 两 个 触摸 点 之 间 的 距离 

float nowWholeDistance = distance(event.getX(), event.getY(), event.getX(1), event.getY(1)); 

// 上 次 两 个 触摸 点 之 间 的 距离 

float pre WholeDistance = distance(mLastOffsetX, mLastOffsetY, 

mLastOffsetXTwo, mLastOffsetY Two); 

// 主要 点 在 前 后 两 次 落 点 之 间 的 距离 

float primaryDistance = distance(event.getX(), event.getY(), mLastOffsetX, mLastOffsetY); 

/ 次 要 点 在 前 后 两 次 落 点 之 间 的 距离 

float secondaryDistance = distance(event.getX(1), event.getY(1), 
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mLastOffsetXTwo, mLastOffsetYTwo); 
if (Math.abs(nowWholeDistance - preWholeDistance) > 
(float) Math.sqrt(2) / 2.0f * (primaryDistance + secondaryDistance)) { 
// 倾向 于 在 原始 线段 的 相同 方向 上 移动 ， 则 判 作 缩放 图 像 
/ 触发 图 像 变 更 监听 器 的 缩放 图 像 动作 
mListeneronImageScale(nowWholeDistance / preWholeDistance); 
} else{ / 倾向 于 在 原始 线段 的 垂直 方向 上 移动 ， 则 判 作 旋转 图 像 
/ 计算 上 次 触摸 事件 的 旋转 角度 
int preDegree = degree(mLastOffsetX, mLastOffsetY, mLastOffsetXTwo, mLastOffsetY Two); 
// 计算 本 次 触摸 事件 的 旋转 角度 
int nowDegree = degree(event.getX(), event.getY(), event.getX(1), event.getY(1)); 
// 触发 图 像 变更 监听 器 的 旋转 图 像 动 作 
mListeneronImageRotate(nowDegree - preDegree); 


11.6 ”实战 项 目 : 虚拟 现实 的 全 景 图 库 


不 管 是 绘画 还 是 摄影 ， 都 是 把 三 维 的 物体 投影 到 一 个 平面 上 ， 其 实 呈 现 出 来 的 仍旧 是 二 
维 的 模拟 画面 。 随 着 科技 的 发 展 ， 传 统 的 成 像 手 段 越 来 越 凸显 出 局 限 性 ， 缘 由 在 于 人 们 需要 一 
种 更 逼真 更 接近 现实 的 技术 ， 从 而 更 好 地 显示 三 维 世界 的 环境 信息 ， 这 便 催生 了 增强 现实 AR 
和 虚拟 现实 VR。 传 统 的 摄影 只 能 拍摄 90 度 左右 的 风景 ， 而 新 型 的 全 景 相机 则 能 拍摄 360 度 
乃至 720 度 (连同 头 项 和 脚底 在 内 〉 的 场景 ， 这 种 360/720 度 的 相片 即 为 全 景 照片 。 本 章 最 后 
的 实战 项 目 就 来 谈 谈 如 何在 手机 上 查看 这 种 全 景 照片 。 


11.6.1 设计 思 


每 逢 一 年 一 度 的 春运 来 临 ， 无 论 是 火车 站 还 是 飞机 场 ， 到 处 都 是 人 潮 测 涌 。 为 了 做 好 春 
运 期 间 的 安全 保障 工作 ， 各 级 部 门 可 谓 是 八仙 过 海 、 各 显 神通 ， 除 了 加 强 乘客 进 站 / 进 港 时 的 
安检 措施 ， 还 在 候车 室 / 候 机 室 的 各 个 角落 加 装 了 摄像 头 ， 以 便 实 时 监控 候车 室 / 候 机 室 的 旅客 
动态 。 但 是 监控 视频 只 能 在 专门 的 监控 室 里 观看 ， 在 外 执勤 的 安保 人 员 没 法 察看 ， 现 在 有 了 
VR 技术 ， 只 要 把 全 景 相 机 拍摄 的 全 景 照片 发 到 手机 上 ， 无 论 身 在 何方 都 能 及 时 通过 手机 浏览 
全 景 照片 ， 从 而 方便 掌握 最 新 的 现场 情况 。 

壁 如 图 11-41 就 是 一 张 故宫 的 全 景 照片 ， 看 起 来 左右 各 有 两 处 明显 的 扭曲 。 
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图 11-41 故宫 的 全 景 照片 


当然 全 景 照 片 的 扭曲 现象 是 有 意 为 之 ， 目 的 是 保存 上 天 入 地 的 720 度 景物 数据 。 仰 望 星 
空 ,环顾 四 周 ， 莫 然 发 现 原来 繁星 如 画 ， 自 己 在 不 同 角度 看 到 的 仅 是 这 一 幅 天 穹 画 卷 中 的 一 小 
块 截面 。 同 理 ， 全 景 照片 看 似 一 张 矩 形 图 片 ， 其 实 前 后 左右 上 下 的 景色 全 都 襄 括 在 内 ， 但 用 户 
每 次 只 能 观看 某 个 角度 的 截图 。 要 想 观看 其 他 方向 上 的 图 画 ， 就 得 想 办 法 让 全 景 照片 转 起 来 ， 
那么 转动 之 时 可 能 会 用 到 以 下 技术 : 
e 通过 手势 的 触摸 与 滑动 ， 把 全 景 照 片 相应 地 挪动 观测 角度 。 
e 开启 手机 的 陀螺 仪 传感器 (第 9 章 有 介绍 ) ， 随 着 陀螺 仪 的 旋转 角度 变化 ， 让 全 景 照 片 
跟着 变换 x、y、z 三 个 方向 的 角度 。 
e@ 利用 OpenGL ES 库 ( 全 称 “OpenGL for Embedded Systems”， 意 指 说 入 式 系统 上 的 
OpenGL) ， 实 现 平面 的 全 景 照片 转换 为 曲面 的 实景 快照 。 


总 之 , 运用 了 上 述 的 几 项 技术 , 期 望 达到 如 图 11-42 和 图 11-43 所 示 的 效果 , 其 中 图 11-42 
为 打开 全 景 照片 的 初始 画面 ， 图 11-43 为 滑动 屏幕 使 之 切换 到 另 一 个 角度 时 的 画面 。 









全 景 照 片 例子 : 故宫 风光 故宫 风光 县 


本 


全 景 照 片 例子 : 











图 11-42 ”故宫 全 景 照片 的 初始 画面 图 11-43 ”挪动 后 的 故宫 全 景 照片 
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11.6.2 ”小 知识 : 三 维 图 形 接口 OpenGL 


OpenGL 的 全 称 是 “Open Graphics Library”， 意 思 是 开放 图 形 库 ， 它 定义 了 一 个 跨 语言 、 
跨 平台 的 图 形 图 像 程序 接口 。 对 于 Android 开发 者 来 说 ，OpenGL 就 是 用 来 绘制 三 维 图 形 的 技 
术 手 段 ， 当 然 OpenGL 并 不 仅 限于 展示 静止 的 三 维 图 形 ， 也 能 用 来 播放 运动 着 的 三 维 动画 。 不 
管 是 三 维 图 形 还 是 三 维 动画 , 都 是 力求 在 二 维 的 手机 屏幕 上 面 展现 模拟 的 真实 世界 场景 , 这 个 
OpenGL 的 应 用 方向 说 到 底 ， 就 是 时 下 大 热 的 虚拟 现实 。 

看 起 来 OpenGL 是 很 高 大 上 的 样子 ， 其实 Android 系统 早已 集成 了 相关 的 API， 只 要 开发 
者 按照 函数 要 求 依次 调用 , 就 能 一 步 一 步 在 手机 屏幕 上 画 出 各 式 各 样 的 三 维 物 体 了 。 不 过 对 于 
初次 接触 OpenGL 的 开发 者 来 说 ， 三 维 绘图 的 概念 可 能 过 于 抽象 ， 所 以 为 了 有 利于 读者 理解， 
下 面 就 以 Android 上 的 二 维 图 形 绘制 为 参考 ， 亦 步 亦 趋 地 逐步 消化 OpenGL 的 相关 知识 点 。 

从 前 面 的 学 习 可 以 得 知 , 每 个 Android 界面 上 的 控件 ,其实 都 是 在 某 个 视图 上 绘制 规定 的 
文字 (如 TextView) ,或 者 绘制 指定 的 图 像 (如 ImageView) 。 而 TextView 和 ImageView 都 
继承 自 基本 视图 View， 这 意味 着 首先 要 有 一 个 专门 的 绘图 场所 ， 比 如 现实 生活 中 的 黑板 、 画 
板 和 桌子 。 然 后 还 要 有 绘画 作品 的 载体 ， 比 如 显示 生活 中 黑板 的 漆 面 ， 以 及 用 于 国画 的 宣纸 、 
用 于 油画 的 油 布 等 等 ， 在 Android 系统 中 ， 这 个 绘画 载体 便 是 画布 Canvas。 有 了 绘图 场所 和 
绘画 载体 , 还 得 有 一 把 绘图 工具 , 不 管 是 勾勒 线条 还 是 涂抹 颜料 都 少不了 它 ， 如 果 是 写 黑板 报 
则 有 粉笔 ,如果 是 画 国 画 则 有 毛笔 :如果 是 画 油 画 则 有 油画 笔 ， 如 果 是 画 Android 控件 则 有 画 
笔 Paint。 

所 以 ， 只 要 具备 了 绘图 场所 、 绘 画 载 体 、 绘 图 工具 ， 即 可 挥毫 泼墨 进行 绘画 创作 。 正 如 
前 面 介绍 的 Android 自 定义 控件 那样 ， 有 了 视图 View、 画 布 Canvas、 夯 笔 Paint， 方 能 绘制 炫 
彩 多 姿 的 各 种 控件 。 那么 对 于 OpenGL 的 三 维 绘图 来 说 ,也 同样 需要 具备 这 三 种 要 素 , 分 别 是 
GLSurfaceView、GLSurfaceView.Renderer 和 GL10， 其 中 GLSurfaceView 继承 自 表 面 视图 
SurfaceView， 对 应 于 二 维 绘图 的 View; GLSurfaceView.Renderer 是 三 维 图形 的 泻 染 器 ， 对 应 
于 二 维 绘图 的 Canvas; 最 后 一 个 GL10 自然 相当 于 二 维 绘图 的 Paint 了 。 有 了 GLSurfaceView、 
GLRender 和 GL10 这 三 驾 马 车 ，Android 才能 实现 OpenGL 的 三 维 图 形 泻 染 功能 。 

具体 到 App 编码 上 面 ， 还 得 将 GLSurfaceView、GLSurfaceView.Renderer 和 GL10 这 三 个 
类 有 机 结合 起 来 ， 即 通过 函数 调用 关联 它们 三 个 小 伙伴 。 首 先 从 布局 文件 获得 GLSurfaceView 
的 控件 对 象 ， 然 后 调用 该 对 象 的 setRenderer 方法 设置 三 维 泻 染 器 ， 这 个 三 维 泻 染 器 实现 了 
GLSurfaceView.Renderer 定义 的 三 个 视图 函数 ， 分 别 是 onSurfaceCreated、onSurfaceChanged 
和 onDrawFrame, 这 三 个 函数 的 输入 参数 都 包含 GL10, 也 就 是 说 这 三 个 函数 都 持 有 画笔 对 象 。 
如 此 ， 绘 图 三 要 素 的 GLSurfaceView、GLSurfaceView.Renderer 和 GL10 就 互相 关联 了 起 来 。 

可 是 ，Renderer 接口 定义 的 onSurfaceCreated、onSurfaceChanged 和 onDrawFrame 三 个 函 
数 很 是 陌生 ， 它 们 之 间 又 有 什么 区 别 呢 ? 为 方便 理解 ， 接 下 来 不 妨 继续 套用 Android 二 维 绘图 
的 有 关 概念 ， 从 Android 自 定 义 控件 的 主要 流程 得 知 ， 自 定义 一 个 二 维 控件 ， 主 要 有 以 下 4 个 
步骤 : 

人 EXOi) 声明 自 定义 控件 的 构造 函数 ， 可 在 此 进行 控件 属性 初始 赋值 等 初始 化 操作 。 

C302 重 写 mMeasure 函数 ， 可 在 此 测量 控件 的 宽度 和 高 度 。 
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人 63 重 写 onLayout 函数 ， 可 在 此 挪动 控件 的 位 置 。 
人 64 重 写 onDraw 函数 ， 可 在 此 绘制 控件 的 形状 、 颜 色 、 文 字 以 及 图 案 等 等 。 





于 是 前 面 提 到 Renderer 接口 定义 的 三 个 函数 ， 它 们 的 用 途 对 照 说 明 如 下 : 


e@ onSurfaceCreated 函数 在 GLSurfaceView 创建 时 调用 , 相当 于 自 定义 控件 的 构造 函数 ， 一 
样 可 在 此 进行 三 维 绘图 的 初始 化 操作 。 

e@ onSurfaceChanged 函数 在 GLSurfaceView 创建 、 恢 复 与 改变 时 调用 ， 在 这 里 不 但 要 定义 
三 维 空间 的 大 小 ， 还 要 定义 三 维 物体 的 方位 ， 所 以 该 函数 相当 于 完成 了 自 定义 控件 的 
onMeasure 和 onLayout 两 个 函数 的 功能 。 

e@ onDrawFrame 函数 顾名思义 跟 自 定义 控件 的 onDraw 函数 差不多 ,onDraw 函数 用 于 绘制 
二 维 图 形 的 具体 形状 ， 而 onDrawFrame 函数 用 于 绘制 三 维 图 形 的 具体 形状 。 


下 面 来 个 最 简单 的 OpenGL 例子 ， 在 布局 文件 中 放置 一 个 android.opengl.GLSurfaceView 
节点 ， 后 续 的 三 维 绘图 动作 将 在 该 视图 上 开展 。 布 局 文件 内 容 示 例如 下 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" > 


<!-- 注意 这 里 要 使 用 控件 的 全 路 径 android.opengLGLSurfaceView --> 
<android.opengl.GLSurfaceView 
android:id="(@+id/glsv_content" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 
</LinearLayout> 


接着 在 Activity 代码 中 获取 这 个 GLSurfaceView 对 象 , 并 给 它 注册 一 个 三 维 图 形 的 演 染 器 
GLRender， 此 时 自 定义 的 泻 染 器 GLRender 必须 重 载 onSurfaceCreated、onSurfaceChanged 和 
onDrawFrame 这 三 个 函数 。 下 面 是 对 应 的 Activity 代码 框架 片段 : 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_gl_cub); 
/ 从 布局 文件 中 获取 名 叫 glsv_content 的 图 形 库 表面 视图 
GLSurfaceView glsv_content = (GLSurfaceView) findViewById(R.id.glsv_content); 
/ 给 OpenGL 的 表面 视图 注册 三 维 图 形 的 泻 染 器 
glsv_content.setRenderer(new GLRender()); 

有 


// 定义 一 个 三 维 图 形 的 演 染 器 
private class GLRender implements GLSurfaceView.Renderer { 
/ 在 表面 创建 时 触发 
public void onSurfaceCreated(GL10 gl, EGLConfig config) { 
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/ 这 里 进行 三 维 绘图 的 初始 化 操作 
} 


/ 在 表面 变更 时 触发 
public void onSurfaceChanged(GL10 gl, int width, int height) { 

// 这 里 要 定义 三 维 空间 的 大 小 ， 还 要 定义 三 维 物体 的 方位 
| 


/ 执行 框架 绘制 动作 
public void onDrawFrame(GL10 gD { 
// 这 里 绘制 三 维 图 形 的 具体 形状 
| 


然后 是 OpenGL 具体 的 绘图 操作 ， 这 得 靠 三 维 图 形 的 画笔 GL10 来 完成 。GL10 作为 三 维 
空间 的 画笔 ， 它 所 描绘 的 三 维 物体 却 要 显示 在 二 维 平面 上 ， 显 而 易 见 这 不 是 一 个 简单 的 活 儿 。 
为 了 理 顺 物体 从 三 维 空间 到 二 维 平面 的 变换 关系 ,有 必要 搞 清楚 OpenGL 关于 三 维 空间 的 几 个 
基本 概念 。 下 面 就 概括 介绍 一 下 GL10 编码 的 三 类 常见 方法 。 

1. 颜色 的 取 值 范围 


Android 中 的 三 原色 ， 不 管 是 红色 还 是 绿色 还 是 蓝 色 ， 取 值 范围 都 是 0 到 255， 对 应 的 十 
六 进 制 数值 则 为 00 到 FF, 颜色 数值 越 小 表示 亮度 越 弱 , 数值 越 大 表示 亮度 越 强 。 但 在 OpenGL 
之 中 , 颜色 的 取 值 范围 却 是 0.0 到 1.0， 其 中 0.0 对 应 Android 标准 的 0，1.0 对 应 Android 标准 
的 255， 同 理 ，OpenGL 值 为 0.5 的 颜色 对 应 Android 标准 的 128。 

GL10 与 颜色 有 关 的 方法 主要 有 两 个 ， 说 明 如 下 。 

e 8glClearColor : 设置 背景 颜色 。 以 下 代码 表示 给 三 维 空间 设置 白色 背景 : 


/ 设置 白色 背景 。 四 个 参数 依次 为 透明 度 alpha、 红 色 red、 绿 色 green、 蓝 色 blue 
gl.glClearColor(1.0f, 1.0£, 1.0f, 1.0f); 


e@ ”glColor4f: 设置 画笔 颜色 。 以 下 代码 表示 把 画笔 颜色 设置 为 橙色 : 


/ 设置 画笔 颜色 为 橙色 
gl.glColor4f(0.0f, 1.0f 1.0f 0.0D: 


2. 三 维 坐标 系 


三 维 空间 用 来 表达 立体 形状 ， 需 要 三 个 方向 的 坐标 ， 分 
别 为 水 平方 向 的 x 轴 和 y 轴 , 以 及 垂直 方向 的 z 轴 。 如 图 11-44 
所 示 的 三 维 坐标 系 ， 三 维 空间 有 个 M 点 ， 该 点 在 x 轴 上 的 投 
影 为 P 点 , 在 y 轴 上 的 投影 为 Q 点 , 在 z 轴 上 的 投影 为 R 点 ， 
因此 M 点 的 坐标 位 置 就 是 (P,Q,R》。 

既然 三 维 空间 中 的 每 个 点 都 存在 x*、y、z 三 个 方向 的 坐 





11-44 ”三维 坐标 空间 
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标 值 ， 那 么 与 物体 位 置 有 关 的 方法 均 需 提供 x、y、z 三 个 方向 的 数值 。 比 如 物体 的 旋转 方法 
glRotatef、 平 移 方法 glTranslatef、 缩 放 方 法 glScalef， 要 分 别 指定 物体 在 三 个 坐标 轴 上 的 旋转 
方向 、 平 移 距 离 、 缩 放 倍率 。 具 体 的 方法 调用 例子 如 下 所 示 : 

/ 沿 着 y 轴 的 负 方 向 旋转 90 度 

gl.glRotateft90, 0, -1, 0); 

// 沿 x 轴 方向 移动 1 个 单位 

gl.glTranslatef(1, 0, 0); 

/x，y，z 三 方向 各 缩放 0.1 倍 

gl.glScalef(0.1f. 0.1f 0.1f); 


3. 坐标 矩阵 变换 


有 了 三 维 坐标 系 ， 还 要 把 三 维 物体 投影 到 二 维 平面 上 ， 才 能 在 手机 屏幕 中 绘制 三 维 图形 。 
这 个 投影 操作 主要 有 3 个 步骤 ， 下 面 分 别 展开 叙述 : 


(1) 设置 绘图 区 域 


前 面 讲 过 OpenGL 使 用 GLSurfaceView 这 个 控件 作为 绘图 场所 ， 于 是 允许 绘制 的 区 域 范 
围 自然 落 在 GLSurfaceView 内 部 。 设 置 绘图 区 域 的 方法 是 glViewport， 它 指定 了 该 区 域 左 上 角 
的 平面 坐标 ， 以 及 区 域 的 宽度 和 高 度 。 当 然 一 般 OpenGL 的 绘图 范围 与 GLSurfaceView 的 大 
小 重合 ， 所 以 倘若 GLSurfaceView 控件 的 宽度 为 width， 高 度 为 height， 则 设置 绘图 区 域 的 方 
法 调用 示例 如 下 : 
/ 设置 输出 屏幕 大 小 
gl.glViewport(0, 0, width, height); 


(2) 调整 镜头 参数 


框 住 了 绘图 区 域 ， 还 要 把 三 维 物体 在 二 维 平面 上 的 投影 一 点 一 点 描绘 进去 才 行 ， 这 中 间 
的 坐标 变换 计算 由 OpenGL 内 部 自行 完成 , 开发 者 无 需 关 注 具体 的 运算 逻辑 。 好 比 日 常生 活 中 
的 拍照 , 用 户 只 管 拿 起 手机 咱 咏 一 下 ,根本 不 用 关心 摄像 头 怎么 生成 照片 。 用 户 所 关心 的 照片 
效果 ,不 外 平 景 物 是 大 还 是 小 ， 是 远 还 是 近 ; 用 专业 一 点 的 术语 来 讲 ， 景 物 的 大 小 由 镜头 的 焦 
距 决 定 ， 景 物 的 远近 由 镜头 的 视 距 决 定 。 

对 于 镜头 的 焦距 而 言 ， 拍 摄 同样 尺寸 的 照片 ， 广 角 镜 头 看 到 的 景物 比 标准 镜头 看 到 的 景 
物 更 多 , 这 意味 着 单个 景物 在 广角 镜头 中 会 比较 小 ， 从 而 照片 面积 不 增 大 、 容 纳 的 景物 却 变 多 
了 。 

对 于 镜头 的 视 距 而 言 ， 它 表示 镜头 的 视力 好 坏 ， 即 最 近 能 看 到 多 近 的 景物 ， 最 远 能 看 到 
多 远 的 景物 。 在 日 常生 活 当中 , 每 个 人 的 睫毛 离 自 己 的 眼睛 太 近 了 , 这么 近 的 东西 能 看 得 清楚 
吗 ? 所 以 必须 规定 一 下 , 最 近 只 能 看 清楚 比如 离 眼 睛 十 厘米 的 物体 。 很 遥远 的 景物 自然 也 是 看 
不 清楚 的 ， 所 以 也 要 规定 一 下 ， 比 如 最 远 只 能 看 到 一 公里 之 内 的 人 影 。 这 个 能 看 清 景 物 的 最 近 
距离 和 最 远 距离 ， 就 构成 了 镜头 的 视 距 。 

所 以 ,镜头 的 焦距 是 横向 的 ， 它 反映 了 画面 的 广度 ; 而 镜头 的 视 距 是 纵向 的 ， 它 反映 了 
画面 的 深度 。 在 OpenGL 中 ， 这 些 镜 头 参数 的 调节 依赖 于 GL10 的 gluPerspective 方法 ， 具 体 
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的 参数 调整 代码 举例 如 下 : 

// 设置 投影 矩阵 , 对 应 gluPerspective( 调 整 相机 参数 )、glFrustum 人 (调整 透视 投影 )、 glOrthof( 调 整 正 投影 ) 

gl.glMatrixMode(GL10.GL PROJECTION); 

// 重 置 投影 矩阵 ， 即 去 掉 所 有 的 参数 调整 操作 

gl.glLoadIdentity(); 

// 设置 透视 图 视窗 大 小 。 第 二 个 参数 是 焦距 的 角度 ， 第 四 个 参数 是 能 看 清 的 最 近 距 离 ， 第 五 个 参数 是 
能 看 清 的 最 远 距离 

GLU.gluPerspective(gl, 40, (float) width / height, 0.1f 20.0); 


(3) 挪动 观测 方位 


调整 好 了 镜头 的 拍照 参数 ， 要 不 要 再 摆 个 POSE， 来 个 花 式 摄影 ? 比如 用 户 跃 上 好 几 级 台 
阶 ， 居高临下 拍摄 ， 也 可 俯 下 身子 ， 从 下 向 上 拍摄 ， 还 能 把 手机 横 过 来 拍 或 者 倒 过 来 拍 。 要 是 
怕 摄 影 家 累 坏 了 ,不妨 叫 摆 拍 的 模特 自己 挪动 身影 , 或 者 走 进 或 者 走 远 , 往 左 靠 一 点 或 者 往 右 
靠 一 点 ， 还 可 以 躺 下 来 甚至 倒立 过 来 。 

因此 ， 不 管 是 挪动 相机 的 位 置 ， 还 是 挪动 物体 的 位 置 ， 都 会 让 照片 里 的 景物 发 生变 化 。 
挪动 相机 的 位 置 ， 依 靠 的 是 GL10 的 gluLookAt 方 法 ; 至 于 挪动 物体 的 位 置 ， 依 靠 的 则 是 旋转 
方法 glRotatef、 平移 方法 glTranslatef， 以 及 缩放 方法 glScalef 了 。 下 面 是 OpenGL 挪动 相机 位 
置 的 方法 调用 代码 : 

// 选择 模型 观察 矩阵 ， 对 应 gluLookAt (人 动 )、glTranslatef/glScalef/glIRotatef( 物 动 ) 

gl.glIMatrix Mode(GL10.GL MODELVIEW); 

// 重 置 模型 矩阵 ， 即 去 掉 所 有 的 位 置 挪动 操作 

gl.glLoadIldentity(); 

/ 设置 镜头 的 方位 。 第 二 到 第 四 个 参数 为 相机 的 位 置 坐标 ， 第 五 到 第 七 个 参数 为 相机 画面 中 心 点 的 坐 
标 ， 第 八 到 第 十 个 参数 为 朝 上 的 坐标 方向 ， 比 如 第 八 个 参数 为 1 表示 x 轴 朝 上 ， 第 九 个 参数 为 1 表示 y 轴 朝 
上 ， 第 十 个 参数 为 1 表示 z 轴 朝 上 

GLU.gluLookAt(gl, 10.0f 8.0f, 6.0f 0.0f 0.0f, 0.0f;, 0.0f 1.0f 0.09; 


注意 到 前 面 调整 相机 参数 和 挪动 相机 位 置 这 两 个 动作 ， 都 事先 调用 了 glMatrixMode 与 
glLoadIdentity 方法 ， 这 是 什么 缘故 呢 ? 其 实 这 两 个 方法 结合 起 来 只 不 过 是 状态 重 置 操作 ， 好 
比 把 手机 恢复 出 厂 设置 ， 接 下 来 重新 进行 状态 设置 。glMatrixMode 方法 的 参数 指定 了 重 置 操 
作 的 类 型 ， 像 GL10.GL PROJECTION 类 型 涵盖 了 所 有 的 镜头 参数 调整 方法 ， 包 括 
gluPerspective〈 调 整 相机 参数 ) 、glFrustumf (调整 透视 投影 ) 、glOrthof (调整 正 投影 ) 三 种 
方法 ， 每 次 重 置 GL10.GL_PROJECTION 类 型 ， 意 味 着 之 前 的 这 三 种 参数 设置 统统 失效 。 而 
GL10.GL_MODELVIEW 类 型 涵盖 的 是 位 置 变换 的 相关 方法 ,包括 挪动 相机 的 gluLookAt 方法， 
以 及 挪动 物体 的 glTranslatef/glScalef/glRotatef 方法 ， 每 次 重 置 GL10.GL_MODELVIEW 类 型 ， 
意味 着 之 前 的 位 置 挪动 统统 失效 。 

现在 了 解 了 以 上 的 三 维 绘图 的 常见 方法 ， 接 下 来 再 看 OpenGL 的 应 用 代码 就 会 比较 轻松 
了 。 先 来 看 看 一 个 最 简单 的 三 维 立 方 体 是 如 何 实现 的 , 下 面 是 OpenGL 绘制 立方 体 的 代码 例子 
片段 : 





protected void onCreate(Bundle savedInstanceState) { 
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super.onCreate(savedInstanceState); 
setContentView(R.layout.activity gl_cube); 

initVertexs0; / 初始 化 立方 体 的 顶点 集合 ， 后 面 会 再 具体 说 明 
/ 从 布局 文件 中 获取 名 叫 glsv_content 的 图 形 库 表面 视图 
glsv_content = (GLSurfaceView) fndViewById(R.id.glsv_content); 
/ 给 OpenGL 的 表面 视图 注册 三 维 图 形 的 泻 染 器 
glsv_content.setRenderer(new GLRender()); 


// 定义 一 个 三 维 图 形 的 泻 染 器 

private class GLRender implements GLSurfaceView.Renderer { 

/ 在 表面 创建 时 触发 

public void onSurfaceCreated(GL10 gl, EGLConfig config) { 


(调整 正 投影 ) 


} 


/ 设置 白色 背景 。0.0f 相当 于 00，1.0f 相当 于 FF 
gl.glClearColor(1.0£, 1.0f 1.0f 1.0f); 

/ 启用 阴影 平滑 
gl.glShadeModel(GL10.GL_SMOOTH); 


/ 在 表面 变更 时 触发 
public void onSurfaceChanged(GL10 gl, int width, int height) { 


} 


/ 设置 输出 屏幕 大 小 
gl.glViewport(0, 0, width, height); 


// 设置 投影 矩阵 ,对 应 gluPerspective (调整 相机 )、glFrustumf (调整 透视 投影 )、glOrthof 


gl.glIMatrixMode(GL10.GL_PROJECTION); 

// 重 置 投 影 矩 阵 ， 即 去 掉 所 有 的 平移 、 缩 放 、 旋 转 操作 
glLgILoadIdentityO; 

// 设置 透视 图 视窗 大 小 

GLU.gluPerspective(gl, 40, (float) width / height, 0.1f 20.0f); 


// 选择 模型 观察 矩阵 ， 对 应 gluLookAt (人 动 )、glTranslatef/glScalef/glRotatef 物 动 ) 


gl.glIMatrixMode(GL10.GL_ MODELVIEW); 
// 重 置 模型 矩阵 
gLgILoadIdentity0; 


/ 执行 框架 绘制 动作 
public void onDrawFrame(GL10 gD { 


// 清除 屏幕 和 深度 缓存 

gl.glClear(GL10.GL COLOR_BUFFER_BIT1GL10.GL_DEPTH _ BUFFER_BIT); 
// 重 置 当 前 的 模型 观察 矩阵 

gLgILoadIdentity0; 

/ 设置 画笔 颜色 
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gLglColor4ft0.0f 0.0f 1.0f 1.00; 

// 设置 观测 点 。eyeXYZ 表示 眼睛 坐标 , centerXYZ 表示 原点 坐标 , upX=1 表示 X 轴 朝 上 ， 
upY=1 表示 YY 轴 朝 上 ，upZ=1 表示 Z 轴 朝 上 

GLU.gluLookAt(gl, 10.0f 8.0f, 6.0f, 0.0f, 0.0£, 0.0f, 0.0f 1.0f, 0.0f); 

// 绘制 一 个 立方 体 ， 后 面 会 再 具体 说 明 

drawCube(gl); 


} 


上 面 代码 主要 完成 三 维 物体 绘制 前 的 准备 工作 , 接 下 来 继续 介绍 如 何 利 用 GL10 进行 实际 
的 三 维 绘图 操作 。 首 先 在 三 维 坐 标 系 中， 每 个 点 都 有 x、y、z 三 个 方向 上 的 坐标 值 ， 这 样 需 要 





三 个 浮 点 数 来 表示 一 个 点 然后 一 个 面 又 至 少 由 三 个 点 组 成 ,例如 三 个 点 可 以 构成 一 个 三 角形 ， 
而 四 个 点 可 以 构成 一 个 四 边 形 。 于 是 OpenGL 使 用 浮 点 数组 表达 一 块 平面 区 域 的 时 候 , 数组 大 


小 = 该 面 的 顶点 个 数 *3， 也 就 是 说 ， 每 三 个 浮 点 数 用 来 指定 一 个 顶点 的 x、y、z 三 轴 坐 标 ， 所 
以 总 共 需 要 三 倍 于 顶点 数量 的 浮 点 数 才能 表示 这 些 顶 点 构成 的 平面 ,以 下 举 个 定义 四 边 形 的 浮 
点 数组 例子 : 


// 四 边 形 的 顶点 坐标 数组 ， 每 三 个 数组 元 素 代表 一 个 坐标 点 〈 含 x、y、z) 
float verticesFront[] = ff II IIE-IE -1£ 1£ -1f, -lf 1f, 1f}; 


上 述 的 浮 点 数组 一 共有 12 个 浮 点 数 ， 其 中 每 三 个 浮 点 数 代表 一 个 点 ， 因 此 这 个 四 边 形 由 
下 列 坐 标的 顶点 构成 : 点 1 坐标 (1.1,1) 、 点 2 坐标 (11-1) 、 点 3 坐标 (-1,1,-1) 、 点 4 
坐标 (-1,1,1) 。 
不 过 这 个 浮 点 数组 并 不 能 直接 传 给 OpenGL 处 理 ， 因 为 OpenGL 的 底层 是 用 C 语言 实现 
的 ，C 语言 与 其 他 语言 (如 Java) 默认 的 数据 存储 方式 在 字 节 顺序 上 可 能 不 同 〈 如 大 端 小 端 问 
题 ) ， 所 以 其 他 语言 的 数据 结构 必须 转换 成 C 语言 能 够 识别 的 形式 ， 说 白 了 就 是 翻译 。 这 里 
面 C 语言 能 听 懂 的 数据 结构 名 叫 FloatBuffer, 于 是 问题 的 实质 就 变 成 了 如 何 将 浮 点 数组 folat[] 
转换 为 浮 点 缓存 FloatBuffer， 具 体 的 转换 过 程 已 经 有 了 现成 的 模板 ， 开 发 者 只 管 套 进去 即 可 ， 
详细 的 转换 函数 代码 如 下 所 示 : 
public static FloatBuffer getFloatBuffer(float[] array) { 
// 初始 化 字 节 缓冲 区 的 大 小 = 数组 长 度 * 数 组 元 素 大 小 。float 类 型 的 元 素 大 小 为 Float.SIZE， 
/int 类 型 的 元 素 大 小 为 ntegerSIZE，double 类 型 的 元 素 大 小 为 Double.SIZE。 
ByteBuffer byteBuffer = ByteBuffer.allocateDirect(array.length * Float.SIZE); 
// 以 本 机 字 节 顺序 来 修改 字 节 缓冲 区 的 字 节 顺序 
// OpenGL 在 底层 的 实现 是 C 语言 ， 与 Java 默认 的 数据 存储 字 节 顺序 可 能 不 同 ， 即 大 端 小 端 问题 。 
/ 因此 ， 为 了 保险 起 见 ， 在 将 数据 传递 给 OpenGL 之 前 ， 需 要 指明 使 用 本 机 的 存储 顺序 
byteBuffer.order(ByteOrder.nativeOrder()); 
/ 根据 设置 好 的 参数 构造 浮 点 缓冲 区 
FloatBuffer floatBuffer = byteBuffer.asFloatBuffer(); 
// 把 数组 数据 写 入 缓冲 区 
floatBuffer.put(array); 
/ 设置 浮 点 缓冲 区 的 初始 位 置 
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floatBuffer.position(0); 
return floatBuffer; 
} 


现在 有 了 可 供 OpenGL 识别 的 FloatBuffer 对 象 ， 接 着 描绘 三 维 图 形 就 有 章 可 循 了 。 绘 制 

图 形 之 前 要 先 调用 glEnableClientState 方法 启用 顶点 开关 ， 绘 制 完成 之 后 要 调用 
glDisableClientState 方法 禁用 顶点 开关 , 在 这 两 个 方法 之 中 再 进行 实际 的 点 、 线 、 面 绘制 操作 。 
下 面 是 绘制 三 维 图 形 的 函数 调用 顺序 示例 : 

/ 启用 项 点 开关 

agl.glEnableClientState(GL10.GL_VERTEX_ARRAY); 

// 指定 三 维 物 体 的 顶点 坐标 集合 

// gl.glVertexPointer(***); 

// 在 顶点 坐标 集合 之 间 绘制 点 、 线 、 面 

// gl.glDrawArrays(***); 

/ 禁用 顶点 开关 

al.glDisableClientState(GL10.GL_VERTEX_ARRAY): 


注意 到 上 面 代码 给 出 了 描绘 动作 的 两 个 方法 glVertexPointer 和 glDrawArrays, 其 中 前 者 指 
定 了 三 维 物体 的 顶点 坐标 集合 ， 后 者 才 在 顶点 坐标 集合 之 间 绘 制 点 、 线 、 面 。 那 么 这 两 个 方法 
的 输入 参数 又 是 怎样 取 值 的 呢 ? 先 来 看 看 glVertexPointer 方法 的 函数 参数 定义 ， 说 明 如 下 : 
void glVertexPointer( 
int size， // 指定 顶点 的 坐标 维度 。 三 维 空 间 有 x、y、z 三 个 坐标 轴 ， 所 以 三 维 空间 的 size 为 3。 
同 理 ， 二 维 平面 的 size 为 2， 相对 论 时 空 观 的 size 为 4〈 三 维 空间 + 时 间 ) 
int type， // 指定 顶点 的 数据 类 型 。 GL10.GL_FLOAT 表示 浮 点 数 , GL_SHORT 表示 短 整 型 ， 等 等 。 
int stride， / 指定 顶点 之 间 的 间隔 。 通 常 取 值 为 0， 表 示 这 些 顶 点 是 连续 的 。 
java.nio.Buffer pointer // 所 有 顶点 坐标 的 数据 集合 。 这 个 便 是 前 面 转换 而 来 的 FloatBuffer 对 象 了 。 
); 
通常 情况 下 ，OpenGL 用 于 处 理 三 维 空间 的 连续 项 点 的 图 形 绘制 ， 故 而 一 般 可 按 以 下 格式 
调用 glVertexPointer 方法 : 
/ 三维 空 间 ， 顶 点 的 坐标 值 为 浮 点 数 ， 且 顶点 是 连续 的 集合 
al.glVertexPointer(3, GL10.GL_FLOAT., 0, buffer): 


再 来 看 看 glIDrawArrays 方法 的 函数 参数 定义 ， 说 明 如 下 : 
void glDrawArrays( 
int mode， // 指定 顶点 之 间 的 绘制 模式 。 是 只 描绘 点 ， 还 是 描绘 顶点 之 间 的 线段 ， 还 是 描绘 顶点 
构成 的 平面 。 
int first，。 // 从 第 first 个 顶点 开始 绘制 。 若 无 意外 都 是 取 值 0,， 表示 从 数组 下 标的 第 0 个 开始 绘制 。 
int count// 本 次 绘制 操作 的 顶点 数量 。 也 就 是 说 ， 从 第 first 个 点 描绘 到 第 firsttcount) 个 顶点 。 


这 里 补充 介绍 一 下 glDrawArrays 方法 的 绘制 模式 取 值 ， 常 见 的 几 种 绘制 模式 取 值 说 明 见 
表 11-3。 
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glDrawArrays 方法 的 绘制 模式 


表 11-3 ”绘制 模式 的 取 值 说 明 
说 明 





GL10.GL POINTS 


只 描绘 各 个 独立 的 点 





GLI0.GL_LINE_STRIP 


前 后 两 个 顶点 用 线段 连接 ， 但 不 闭合 〈 最 后 一 个 点 与 第 一 个 点 不 连接 ) 





GL10.GL LINE LOOP 


前 后 两 个 项 点 用 线段 连接 ， 并 且 闭 合 ( 最 后 一 个 点 与 第 一 个 点 有 线段 连 
接 ) 





GL10.GL_TRIANGLES 





每 隔 三 个 顶点 绘制 一 个 三 角形 的 平面 





按照 目前 的 演示 要 求 ， 
glDrawArrays 方法 : 


只 需 绘制 一 个 立方 体 的 线段 框架 ， 因 此 可 按 以 下 格式 调用 


// 每 个 面 画 闭合 的 四 边 形 线段 ， 从 第 0 个 点 开始 绘制 ， 绘 制 四 边 形 的 所 有 项 点 (pointCount=4) 
gl.glDrawArrays(GL10.GL_LINE LOOP, 0, pointCount); 


好 不 容易 喝 陵 了 这 么 多 ， 绘 制 一 个 简单 的 立方 体 已 经 八 九 不 离 十 了 ， 下 面 是 立方 体 的 图 


形 绘制 代码 片段 : 


// 下 面 声明 立方 体 六 个 面 的 顶点 集合 ， 并 初始 化 每 个 面 的 浮 点 数组 
private ArrayList<FloatBuffer> mVertices = new ArrayList<FloatBuffer>(); 
float[] verticesFront = { 1f, 1f, 1f, IEIE-IE -lf 1f -1f -lf 1f, 1f}; 
float[] verticesBack = { 1£, -1£f, 1£ 1£,-1f,-1f, -1f,-1f,-1f, -1f, -1f, 1f}; 
float[] verticesTop= { 1f,1f,1f, 1f,-1f,1f, -IE-IEIE -1f, 1f, 1f}; 
float[] verticesBottom = { 1£, 1f,-1f 1f,-1f,-1f, -1f,-1f,-1f,-1f, 1£ -1f}; 
float[] verticesLeft = { -1f, 1f, 1f, -1f, 1f,-1f, -1f,-1f,-1f -1f, -1f, 1f}; 
float[] verticesRight= { 1£ 1£ 1f, 1f, 1f,-1f IE-IE-IE 1f, -1f, 1f}; 
int pointCount = verticesFront.length/3; / 组 成 立方 体 的 顶点 总 数 


// 把 项 点 集合 的 数据 结构 由 float[] 转 换 为 FloatBuffer 


Pprivate void initVertexsO { 


mVertices.add(FileUtil.getFloatBuffer(verticesFront)); 
mVertices.add(FileUtil.getFloatBuffer(verticesBack)); 
mVertices.add(FileUtil.getFloatBuffer(verticesTop)); 
mVertices.add(FileUtil.getFloatBuffer(verticesBottom)); 
mVertices.add(FileUtil.getFloatBuffer(verticesLeft)); 
mVertices.add(FileUtil.getFloatBuffer(verticesRight)); 


1 


/ 根据 顶点 数据 集合 ， 绘 制 立方 体 的 线段 框架 
private void drawCube(GL10 gD { 


/ 启用 项 点 开关 


gl.glEnableClientState(GL10.GL_ VERTEX_ARRAY); 
/ 立方 体 由 六 个 正方 形 平面 组 成 
for (FloatBuffer buffer : mVertices) { 

// 将 三 维 物体 的 顶点 坐标 传 给 OpenGL 管道 
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gl.glVertexPointer(3, GL10.GL_FLOAT., 0, buffer); 
/GL _ LINE LOOP 表示 用 画 线 的 方式 将 点 连接 并 画 出 来 
gl.glDrawArrays(GL10.GL_LINE LOOP, 0, pointCount); 
} 
/ 禁用 项 点 开关 
gl.glDisableClientState(GL10.GL_ VERTEX_ARRAY); 
立方 体 算是 最 简单 的 三 维 物 体 了 ， 倘 若是 一 个 球体 ， 也 能 按照 上 述 的 代码 逻辑 绘制 球形 
框架 , 当然 这 个 近似 球体 需要 由 许多 个 小 三 角形 构成 .绘制 完成 的 立方 体 效果 如 图 11-45 所 示 ， 
而 球体 效果 如 图 11-46 所 示 。 





三 维 物体 形状 : 静止 立方 体 三 维 物 体形 状 : 静止 球体 ~ 











图 11-45 立方体 的 三 维 图 形 图 11-46 球体 的 三 维 图 形 


以 上 先后 给 出 的 立方 体 和 球体 效果 图 ， 虽 然 看 起 来 具备 立体 的 轮廓 ， 可 离 真实 的 物体 还 
差 得 远 。 因 为 现实 生活 中 的 物体 不 仅仅 有 个 骨架 ， 还 有 花纹 有 光泽 《比如 衣服 ) ， 所 以 若 想 让 
三 维 物体 更 加 符合 实际 , 就 得 给 它 加 一 层 皮 , 也 可 以 说 是 加 一 件 衣服 , 这 个 皮毛 大 衣 用 OpenGL 
的 术语 称呼 则 为 “纹理 ”。 

三 维 物体 的 骨架 是 通过 三 维 坐 标 系 表示 的 ， 每 个 点 都 有 x、y、z 三 个 方向 上 的 数值 大 小 。 
那么 三 维 物体 的 纹理 也 需要 通过 纹理 坐标 系 来 表达 ， 但 纹理 坐标 并 非 三 维 形式 而 是 二 维 形式 ， 
这 是 怎么 回 事 呢 ? 打 个 比方 ,裁缝 店 给 顾客 制作 一 件 衣服 ,首先 要 丈量 顾客 的 身高 、 肩 宽 ， 以 
及 三 围 , 然后 才能 根据 这 些 身体 数据 剪裁 布料 , 这 便 是 所 谓 的 量体裁衣 。 那 做 衣服 的 一 匹 一 匹 
布料 又 是 什么 样子 的 ? 当然 是 摊 开 来 一 大 片 一 大 片 整 齐 的 布匹 了 , 明显 这 些 布匹 近似 于 二 维 的 
平面 。 但 是 最 终 的 成 品 衣服 穿 在 顾客 身上 却 是 三 维 的 模样 ， 显 然 中 间 必 定 有 个 从 二 维 布匹 到 三 
维 衣服 的 转换 过 程 。 转 换 工作 的 一 系列 计算 ， 高 不 开 前 面 测量 得 到 的 身高 、 肩 宽 、 三 围 等 等 ， 
其 中 身高 和 肩 宽 是 直线 的 长 度 ， 而 三 围 是 曲线 的 长 度 。 如 果 把 三 围 的 曲线 剪断 并 拉 直 ， 就 能 乱 
到 直线 形式 的 三 围 ; 同 理 , 把 衣服 这 个 三 维 的 曲面 剪 开 , 然后 把 它 摊 平 , 得 到 平面 形式 的 衣服 。 
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于 是 ， 剪 开 并 摊 平 后 的 平面 衣服 ， 即 可 与 原始 的 平面 布匹 对 应 起 来 了 。 因 此 ， 纹 理 坐 标的 目的 
就 是 标记 被 摊 平 衣服 的 二 维 坐标 ， 从 而 将 同属 二 维 坐标 系 的 布匹 一 块 一 块 贴 上 去 。 

在 OpenGL 体系 之 中 , 纹理 坐标 又 称 UV 坐标 , 通过 两 个 浮 点 数组 合 来 设置 一 个 点 的 纹理 
坐标 (U,V)， 其 中 U 表示 横 轴 ，YV 表示 纵 轴 。 纹 理 坐 标 不 关心 物体 的 三 维 位 置 ， 好 比 一 个 人 不 
管 走 到 哪里 ， 不 管 做 什么 动作 ， 身 上 穿 的 还 是 那 件 衣服 。 纹 理 坐 标 所 要 表述 的 ， 是 衣服 的 一 小 
片 一 小 片 分 别 来 自 于 哪 块 布料 ， 也 就 是 说 ， 每 一 小 片 衣服 各 是 由 什么 材质 构成 。 既 可 以 是 棉布 
材质 , 也 可 以 是 丝绸 材质 , 还 可 以 是 尼龙 材质 , 纹理 只 是 衣服 的 脉络 , 材质 才 是 贴 上 去 的 花色 。 

给 三 维 物体 穿 衣 服 的 动作 ， 通 常 叫 做 给 三 维 图 形 贴 图 ， 更 专业 地 说 叫 纹理 泻 染 。 泻 染 纹 
理 的 过 程 主要 由 三 大 项 操作 组 成 ， 分 别 说 明 如 下 : 


1. 启用 纹理 的 一 系列 开关 设置 
该 系列 操作 又 包括 下 述 步骤 : 


(1) 泻 染 纹理 肯定 要 启用 纹理 功能 ， 并 且 为 了 能 够 正确 泻 染 ， 还 需 同 时 启用 深度 测试 。 
启用 深度 测试 的 目的 ， 是 只 绘制 物体 朝向 观测 者 的 正面 ， 而 不 绘制 物体 的 背面 。 上 一 篇 文章 的 
立方 体 和 球体 因为 没有 开启 深度 测试 , 所 以 背面 的 线段 也 都 画 了 出 来 。 启用 纹理 与 深度 测试 的 
代码 示例 如 下 : 

/ 启用 某 功能 ， 对 应 的 glDisable 是 关闭 某 功 能 。 

/GL _DEPTH_ TEST 指 的 是 深度 测试 。 启 用 纹理 时 必须 同时 开启 深度 测试 ， 
/ 这 样 只 有 像素 点 前 面 没有 东西 遮挡 之 时 ， 该 像素 点 才 会 予以 绘制 。 
gl.glEnable(GL10.GL_DEPTH_TEST); 

/ 启用 纹理 

al.glEnable(GL10.GL_TEXTURE 2D); 


(2) OpenGL 默认 的 环境 光 是 没有 特定 光源 的 散光 ， 如 果 要 实现 特定 光源 的 光照 效果 ， 
则 需 开 启 灯 照 功 能 ， 另 外 至 少 启用 一 个 光源 , 或 者 同时 启用 多 个 光源 。 下 面 是 只 开启 一 处 灯光 
的 代码 例子 : 
/ 开启 灯 照 效果 
gl.glEnable(GL10.GL_LIGHTING); 
/ 启用 光源 0 
al.glEnable(GL10.GL_LIGHTO); 


(3) 就 像 人 可 以 穿着 多 件 衣服 那样 ， 三 维 物体 也 能 接连 描绘 多 种 纹理 ， 于 是 每 次 泻 染 纹 
理 都 得 分 配 一 个 纹理 编号 。 这 个 纹理 编号 的 分 配 操作 有 点 掀 口 ,开发 者 不 用 太 在 意 ， 只 管 按照 
下 面 例行公事 便 成 : 

/ 使 用 OpenGL 库 创 建 一 个 材质 (Texture)， 首 先 要 获取 一 个 材质 编号 (保存 在 textures 中 ) 
int[] textures = new int[1]; 

gl.glGenTextures(1, textures, 0); 

/ 通知 OpenGL 使 用 这 个 Texture 材质 编号 

gl.glBindTexture(GL10.GL TEXTURE 2D, textures[0]): 
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(4) 如 同 衣服 有 很 宽松 的 款式 ， 也 有 很 紧身 的 款式 ， 对 于 这 些 不 是 那么 合身 的 情况 ， 
OpenGL 要 怎么 去 泻 染 放大 或 者 缩小 了 的 纹理 ? 此 时 就 要 指定 下 述 的 纹理 参数 设置 了 : 
// 用 来 泻 染 的 Texture 可 能 比 要 演 染 的 区 域 大 或 者 小 ， 所 以 需要 设置 Texture 放大 或 缩小 时 的 模式 
/GL_ TEXTURE MAG_FILTER 表示 放大 的 情况 ，GL_TEXTURE_MIN_FILTER 表示 缩小 的 情况 
// 常用 的 两 种 模式 为 GL10.GL_LINEAR 和 GL10.GL_ NEAREST 
// 需要 比较 清晰 的 图 像 使 用 GL10.GL_NEAREST， 而 使 用 GL10.GL_LINEAR 则 会 得 到 一 个 较 模 


糊 的 图 像 
gl.glTexParameterf(GL10.GL_TEXTURE 2D, GL10.GL_TEXTURE MIN_FILTER, 
GL10.GL NEAREST); 
gl.glTexParameterf(GL10.GL_TEXTURE 2D, GL10.GL_TEXTURE MAG FILTER, 
GL10.GL_ LINEAR):; 
// 当 定义 的 材质 坐标 点 超过 UV 坐标 定义 的 大 小 (UV 坐标 为 0.0 到 1,1)， 这 时 需要 告诉 OpenGL 
库 如 何 去 泻 染 这 些 不 存在 的 纹理 部 分 。 
/GL_ TEXTURE_WRAP_S 表示 水 平方 向 ，GL_TEXTURE_WRAP_T 表示 垂直 方向 
/ 有 两 种 设置 : GL_ REPEAT 表示 重复 Texture，GL_CLAMP_ TO_EDGE 表示 只 靠边 线 绘制 一 次 
gl.glTexParameterf(GL10.GL_TEXTURE 2D, GL10.GL_TEXTURE_ WRAP S， 
GL10.GL CLAMP_TO_EDGE); 
gl.glTexParameterf(GL10.GL_TEXTURE 2D,GL10.GL_ TEXTURE WRAP TT, 
GL10.GL CLAMP_TO_EDGE):; 


(5) 最 后 还 要 声明 一 个 位 图 对 象 绑 定 该 纹理 ， 表 示 后 续 的 纹理 泻 染 动作 将 使 用 该 位 图 包 
职 三 维 物 体 ， 绑 定位 图 材质 的 代码 如 下 所 示 : 


/ 将 位 图 Bitmap 资源 和 纹理 Texture 绑 定 起 来 ， 即 指定 一 个 具体 的 材质 
GLUtilstexImage2D(GL10.GL_TEXTURE_2D, 0, mBitmap, 0); 


2. 计算 材质 的 纹理 坐标 


三 维 物 体 的 每 个 顶点 坐标 都 以 (x,y,z) 构 成 ， 因 此 若 要 表达 三 个 顶点 的 空间 位 置 ， 就 需要 大 
小 为 3*3=9 的 浮 点 数组 。 前 面 提 到 纹理 坐标 是 二 维 的 ， 因 此 表达 三 个 顶点 的 纹理 坐标 只 需 大 
小 为 3*2=6 的 浮 点 数组 。 至 于 详细 的 纹理 坐标 计算 ， 则 依据 具体 物体 的 形状 以 及 材质 的 尺寸 
来 决定 ， 这 里 不 再 歼 述 。 


3. 在 三 维 图 形 上 根据 纹理 点 坐标 逐个 贴 上 对 应 的 材质 


演 染 纹理 除了 要 打开 项 点 开关 ， 还 要 打开 材质 开关 。 同 理 ， 绑 定 顶 点 坐标 的 时 候 ， 也 要 
绑 定 纹理 坐标 。 因 为 材质 是 一 片 一 片 的 花色 ， 所 以 调用 glDrawArrays 绘制 方法 时 ， 要 指定 采 
取 GL10.GL_TRIANGLE_STRIP 方式 ， 表 示 本 次 绘图 画 的 是 一 个 三 角形 的 平面 ， 这 样 从 位 图 
对 象 裁剪 出 来 的 花纹 就 贴图 完成 了 。 
下 面 是 进行 材质 贴图 绘制 的 代码 例子 : 
// 绘制 地 球 仪 
Private void drawGlobe(GL10 g) { 
/ 启用 材质 开关 
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al.glEnableClientState(GL10.GL_TEXTURE COORD ARRAY); 
/ 启用 项 点 开关 
agl.glEnableClientState(GL10.GL_ VERTEX_ARRAY); 
for (inti= 0; i<= mDivide; i+H+) { 
/1/ 将 顶点 坐标 传 给 OpenGL 管道 
gl.glVertexPointer(3, GL10.GL_ FLOAT 0, mVertices.get(i)); 
// 声明 纹理 点 坐标 
gl.glTexCoordPointer(2, GL10.GL_FLOAT, 0, mTextureCoords.get(i); 
// GL_LINE_STRIP 只 绘制 线条 ，GL_TRIANGLE _STRIP 才 是 画 三 角形 的 面 
gLglDrawArrays(GL10.GL_TRIANGLE STRIP, 0, mDivide * 2+ 2); 
上 
/ 禁用 顶点 开关 
glLglDisableClientState(GL10.GL_VERTEX_ARRAY); 
/ 禁用 材质 开关 
al.glDisableClientState(GL10.GL_TEXTURE COORD ARRAY); 


接着 观察 一 下 把 世界 地 图 贴 到 球体 上 面 形成 地 球 仪 的 效果 , 图 11-47 是 一 张 原始 的 世界 地 
图 ， 可 以 看 到 底部 的 南极 洲 被 拉 得 很 大 。 





图 11-47 原始 的 世界 地 图 平面 


利用 OpenGL 将 世界 地 图 按照 纹理 坐标 裁剪 后 贴 到 三 维 球体 之 上 ， 贴 图 后 的 三 维 地 球 仪 
如 图 11-48 和 图 11-49 所 示 ， 其 中 图 11-48 展示 了 地 球 仪 的 东 半 球 地 图 ， 图 11-49 展示 了 地 球 
仪 的 西半球 地 图 。 

要 想 让 这 个 地 球 从 西向 东 转 动 起 来 ， 其 实 也 很 容易 。 由 于 GLSurfaceView 的 泻 染 器 会 持 
续 调 用 onDrawFrame 函数 ， 因 此 只 要 在 该 函数 中 设置 渐变 的 变换 数值 ， 即 可 轻松 实现 以 下 的 
三 维 动画 效果 : 

(1) 调用 glRotatef 方法 设置 渐变 的 角度 ， 可 实现 三 维 物体 的 旋转 动画 。 
(2) 调用 glTranslatef 方法 设置 渐变 的 位 移 ， 可 实现 三 维 物体 的 平移 动画 。 
(3) 调用 glScalef 方法 设置 渐变 的 放大 或 缩小 倍率 ， 可 实现 三 维 物体 的 缩放 动画 。 
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球体 贴图 样式 : 











图 11-48 地球 仪 的 东 半 球 地 图 图 11-49 ”地球 仪 的 西半球 地 图 
11.6.3 ”代码 示例 


上 一 小 节 末尾 提 到 ， 只 要 调用 glRotatef 方法 设置 旋转 角度 ， 即 可 完成 三 维 物 体 的 旋转 操 
作 。 那么 对 于 全 景 照片 来 说 , 从 不 同 的 角度 进行 观测 , 其 实 就 是 把 全 景 图 挪动 若干 角度 的 行为 。 
于 是 业务 层面 的 工作 , 便 需 实时 计算 当前 的 偏 移 角度 , 并 将 该 旋转 角度 传 给 三 维 图 形 的 泻 染 器 。 
具体 到 编码 上 面 ， 主 要 关注 以 下 的 三 项 处 理 。 


1. 初始 化 全 景 照片 的 泻 染 器 


该 步骤 需要 声明 OpenGL ES 的 版 本 号 ， 并 指定 全 景 照片 的 资源 编号 ， 以 及 设置 全 景 照片 
的 泻 染 器 。 示 例 代码 如 下 : 
private PanoramaRender mRender; / 声明 一 个 全 景 泻 染 器 


// 传 入 全 景 照片 的 资源 编号 

public void initRender(int drawableId) { 
// 声明 使 用 OpenGL ES 的 版 本 号 为 2.0 
glsv_panorama.setEGLContextClientVersion(2); 
/ 创建 一 个 全 新 的 全 景 泻 染 器 
mRender = new PanoramaRender(mContext); 
setDrawableld(drawableld); 
/ 设置 全 景 照片 的 泻 染 器 
glsv_panorama.setRenderer(mRender); 
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2. 处 理 手势 触摸 事件 引起 的 全 景 照片 变换 


该 步骤 需要 接管 页 面 布局 的 触摸 事件 ， 即 重 写 onTouchEvent 方法 ， 在 侦 听 到 触摸 移动 事 





件 之 时 ， 计 算 相 应 的 旋转 角度 ， 并 传 给 全 景 照片 泻 染 器 。 同 时 注意 规避 触摸 事件 与 陀螺 仪 感应 


之 间 的 冲突 ， 详 细 的 触摸 处 理 代 码 如 下 所 示 : 
private float mPreviousXt, mPreviousYt; // 记 录 触 摸 时 候 的 上 一 次 xy 坐标 位 置 


// 在 发 生 触 摸 事件 时 触发 
public boolean onTouchEvent(MotionEvent event) { 

/ 发 生 触摸 时 先 注销 陀螺 仪 感应 ， 避 免 产 生 冲 突 

mSensorMegr.unregisterListener(this); 

float y = event.getY(); 

float x = event.getX(); 

switch (event.getAction()) { 

case MotionEvent.ACTION_MOVE: // 手指 移动 
// 移动 手势 ， 则 令 全 景 照片 旋转 相应 的 角度 
float dy = y - mPreviousY’s; 
float dx = x - mPreviousXs; 
mRender.yAngle += dx * 0.3f; 
mRender.xAngle += dy * 0.3f; 
break; 
case MotionEvent.ACTION_UP: // 手指 松 开 
// 手势 松 开 ， 则 重新 注册 陀螺 仪 传感器 
mSensorMegr.registerListener(this, mGyroscopeSensor, 
SensorManager.SENSOR_DELAY FASTEST); 

break; 

} 

// 保存 本 次 的 触摸 坐标 数值 

mPreviousYs = y; 

mPreviousXs = x; 

return true; 


i 
3. 处 理 陀螺 仪 感应 引起 的 全 景 照片 变换 


该 步骤 需要 处 理 陀 螺 仪 的 旋转 角度 感应 数据 ， 首 先 要 在 系统 中 注册 一 个 陀螺 仪 监听 器 ， 





然后 重 写 监听 器 的 onSensorChanged 方法 , 在 该 方法 中 分 别 获取 x、y、x 三 个 方向 的 偏 移 角 度 ， 


然后 计算 全 景 图 的 旋转 角度 传 给 泻 染 器 。 下 面 是 与 陀螺 仪 有 关 的 处 理 代 码 : 


private SensorManager mSensorMgrc // 声明 一 个 传 感 管理 器 对 象 

private Sensor mGyroscopeSensor; / 声明 一 个 传感器 对 象 

private float mPreviousXs, mPreviousYs; / 记录 陀螺 仪 感应 的 上 一 次 x、y 坐标 位 置 
private float mTimestamp; / 记录 上 一 次 的 陀螺 仪 感 应 时 间 戳 

private float mAngle[] = new float[3]; / 记录 陀螺 仪 感应 到 的 三 个 方向 的 旋转 角度 
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/ 初始 化 陀螺 仪 
private void initSensor() { 
// 从 系统 服务 中 获取 传 感 管理 器 对 象 
mSensorMegr = (SensorManager) mContext.getSystemService(Context.SENSOR_SERVICE):; 
/ 获得 陀螺 仪 传感器 
mGyroscopeSensor = mSensorMgr.getDefaultSensor(Sensor.TYPE GYROSCOPE); 
/ 给 陀螺 仪 传感器 注册 传 感 监听 器 
mSensorMegr.registerListener(this, mGyroscopeSensor, 
SensorManager.SENSOR DELAY FASTEST); 
’- 


public void onSensorChanged(SensorEvent event) { 
/ 检测 到 陀螺 仪 的 感应 事件 
if (event.sensor.getType() 一 Sensor.TYPE_GYROSCOPE) { 
if (mTimestamp != 0) { 
final float dT = (event.timestamp - mTimestamp) * NS2S; 
mAngle[0] += event.values[0] * dT; 
mAngle[1] += event.values[1] * dT; 
mAngle[2] += event.values[2] * dT; 
float angleX = (float) Math.toDegrees(mAngle[0]); 
float angleY = (float) Math.toDegrees(mAngle[1]); 
float angleZ = (float) Math.toDegrees(mAngle[2]); 
/ 计算 本 次 的 旋转 角度 偏 移 
float dy = angleY - mPreviousYs; 
float dx = angleX - mPreviousXs; 
/ 更 新 全 景 照片 的 旋转 角度 
mRender.yAngle += dx * 2.0f; 
mRender.xAngle += dy * 0.5f; 
/ 计算 本 次 的 旋转 角度 数值 
mPreviousYs = angleY; 
mPreviousXs = angleX; 
} 


mTimestamp = event.timestamp; 


| 


最 后 用 这 个 全 景 照 片 查看 器 来 浏览 全 景 图 ,体验 一 下 身 临 其 境 的 感觉 , 如 图 11-50 所 示 是 
- 张 原始 的 室内 全 景 照 片 ， 拍 摄 范围 包括 客厅 、 和 餐厅、 卧室 、 书 房 、 吊 顶 乃 至 地 板 。 
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图 11-50 原始 的 室内 全 景 照片 
用 查看 器 打开 图 11-50 所 示 的 全 景 照片 ， 一 开始 显示 的 是 过 道 与 餐厅 ， 如 图 11-51 所 示 ; 


然后 手指 在 屏幕 上 滑动 ,全景 图 也 跟着 切换 不 同 的 角度 ， 如 图 11-52 所 示 ， 此 时 滑 到 了 客厅 及 
卧室 的 方向 。 


全 景 照片 例子 : 居家 生活 Rs 


J 
' 





11-51 初始 的 室内 全 景 图 11-52 ”滑动 后 的 室内 全 景 图 


11.7 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 常见 事件 处 理 , 包括 按键 事件 的 检测 与 处 理 (检测 软 键盘 、 
检测 物理 按键 、 音 量 调节 对 话 框 ) 、 触 摸 事 件 的 检测 与 处 理 〈 手 势 事件 的 分 发 流程 、 手 势 事件 
处 理 MotionEvent、 手 写 签名 ) 、 手 势 检测 的 实现 与 用 法 〈 手 势 检测 器 、 飞 掠 视图 、 手 势 控制 横 
幅 轮 播 ) 、 手 势 冲 突 的 处 理 方式 〈 上 下 滚动 与 左右 滑动 的 冲突 处 理 、 内 部 滑动 与 翻 页 滑动 的 冲 
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突 处 理 、 正 常 下 拉 与 下 拉 刷 新 的 冲突 处 理 ) 。 最 后 设计 了 两 个 实战 项 目 ， 一 个 是 “ 抠 图 神器 一 
一 美 图 变 变 ”， 另 一 个 是 “虚拟 现实 的 全 景 图 库 ”。 在 “ 抠 图 神器 一 一 美 图 变 变 ”的 项 目 编码 
中 ， 采 用 了 本 章 介 绍 的 主要 手势 事件 ， 包 括 单 点 触摸 、 多 点 触 控 等 ， 并 介绍 了 二 维 图 像 的 基本 
加 工 操作 。 在 “虚拟 现实 的 全 景 图 库 ” 的 项 目 编码 中 ， 通 过 结合 手势 触摸 与 陀螺 仪 感应 ， 以 及 
三 维 图 形 OpenGL 技术 ， 完 成 了 虚拟 现实 的 功能 运用 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 6 种 开发 技能 : 


(1) 学 会 在 合适 的 场合 监听 并 处 理 按键 事件 。 

(2) 学 会 检测 触摸 事件 并 接管 手势 处 理 。 

(3) 学 会 使 用 主要 的 手势 检测 手段 。 

(4) 学 会 避免 手势 冲突 的 情况 发 生 。 

(5) 学 会 对 二 维 图 像 的 基本 加 工 操 作 〈 含 平移 、 缩 放 、 旋 转 等 ) 。 
(6) 学 会 对 三 维 图 形 的 初步 泻 染 应 用 〈 含 描 点 、 画 线 、 贴 图 等 ) 。 


本 章 介绍 App 开发 常见 的 动画 显示 技术 ， 主 要 包括 如 何 使 用 帧 动画 实现 电影 播放 效果 、 
如 何 使 用 补 间 动 画 完成 视图 的 4 种 基本 状态 变化 如 何 使 用 属性 动画 达成 视图 各 种 状态 的 动态 
变换 效果 、 如 何 使 用 矢量 动画 展现 更 加 精细 的 局 部 炫 动 特效 , 以 及 动画 技术 常用 的 3 种 代表 手 
段 。 最 后 结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 仿 QQ 空间 的 动感 影集 ”的 设计 与 实现 。 


12.1 帧 动画 


本 节 介绍 帧 动画 相关 的 技术 实现 ， 首 先 说 明 如 何 通过 动画 图 形 与 宿主 视图 播放 帧 动画 ， 
接着 阐述 播放 GIF 动画 存在 的 问题 和 对 应 的 解决 思路 与 技术 方案 ， 最 后 介绍 如 何 使 用 过 渡 图 
形 实现 两 幅 图 片 之 间 的 淡 入 、 淡 出 动画 。 


12.1.1 帧 动画 的 实现 


Android 的 动画 分 为 3 大 类 : 帧 动画 、 补 间 动 画 和 属性 动画 。 其 中 ， 帧 动画 是 实现 原理 最 
简单 的 一 种 ， 跟 现实 生活 中 的 电影 胶卷 类 似 ， 都 是 在 短 时 间 内 连续 播放 多 张 图 片 ， 从 而 模拟 动 
态 画 面 的 效果 。 

具体 到 代码 实现 , 帧 动画 由 动画 图 形 AnimationDrawable 生成 。 下 面 是 AnimationDrawable 
的 常用 方法 。 
addFrame: 添加 一 幅 图 片 帧 ， 并 指定 该 帧 的 持续 时 间 (单位 毫秒 ) 。 
setOneShot: 设置 是 否 只 播放 一 次 。 为 true 表示 只 播放 一 次 ， 为 false 表示 循环 播放 。 
start: 开始 播放 。 注 意 ， 设 置 宿主 视图 后 才能 进行 播放 。 
stop: 停止 播放 。 
isRunning: 判断 是 否 正在 播放 。 
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有 了 动画 图 形 ， 还 得 有 一 个 宿主 视图 显示 该 图 形 ， 一 般 使 用 图 像 视 图 ImageView 承载 
AnimationDrawable， 即 调用 ImageView 对 象 的 setImageDrawable 方法 将 动画 图 形 加 载 到 图 像 
视图 中 。 

下 面 是 播放 帧 动画 的 代码 片段 : 

/ 在 代码 中 生成 帧 动画 并 进行 播放 

private void showFrameAnimByCode() { 
/ 创建 一 个 帧 动画 
ad frame = new AnimationDrawable(); 
// 下 面 把 每 帧 图 片 加 入 到 帧 动画 的 队列 中 
ad _frame.addFrame(getResources().getDrawable(R.drawable.flow_p1), 50); 
ad _frame.addFrame(getResources().getDrawable(R.drawable.flow_p2), 50); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow_p3), 50); 





ad frame.addFrame(getResources().getDrawable(R.drawable.flow_p4), 50); 
ad_ frame.addFrame(getResources().getDrawable(R.drawable.flow_p5), 50); 
ad_ frame.addFrame(getResources().getDrawable(R.drawable.flow_p6), 50); 
ad_frame.addFrame(getResources().getDrawable(R.drawable.flow_p7), 50); 
ad_frame.addFrame(getResources().getDrawable(R.drawable.flow_p8), 50); 
// 设置 帧 动画 是 否 只 播放 一 次 。 为 true 表示 只 播放 一 次 ， 为 false 表示 循环 播放 
ad_frame.setOneShot(false); 
/ 设置 图 像 视图 的 图 形 为 帧 动画 
iv_frame_anim.setImageDrawable(ad_frame); 
ad_frame.start(); / 开始 播放 帧 动画 

有 


帧 动画 的 播放 效果 如 图 12-1、 图 12-2、 图 12-3 所 示 。 这 组 帧 动画 实际 由 8 张 党 布 图 片 构 
成 , 图 中 所 示 的 3 张 画 面 为 其 中 的 3 个 瀑布 帧 , 单 看 画面 区 别 不 大 ， 连 起 来 播放 才能 看 到 瀑布 
的 流水 动画 。 


animation 




















图 12-1 瀑布 动画 帧 1 
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除了 在 代码 中 添加 帧 图 片 ， 还 可 以 先 把 帧 图 片 的 排列 定义 在 一 个 XML 文件 中 ; 然后 在 代 
码 中 直接 调用 ImageView 对 象 的 setImageResource 方法 , 加 载 帧 动画 的 图 形 定义 文件 ; 再 调用 
ImageView 对 象 的 getDrawable 方法 ， 获 得 动画 图 形 的 实例 ， 并 进行 后 续 的 播放 操作 。 

下 面 是 帧 图 片 的 定义 文件 : 

<animation-list xmlns:android="http://schemas.android.com/apk/res/android" android:oneshot="false" > 

<item android:drawable="(@drawable/flow_pl1" android:duration="50"/> 
<item android:drawable="(@drawable/flow_p2" android:duration="50"/> 
<item android:drawable="(@drawable/flow_p3" android:duration="50"/> 
<item android:drawable="(@drawable/flow_p4" android:duration="50"/> 
<item android:drawable="(@drawable/flow_p5" android:duration="50"/> 
<item android:drawable="(@drawable/flow_p6" android:duration="50"/> 
<item android:drawable="(@drawable/flow_p7" android:duration="50"/> 
<item android:drawable="(@drawable/flow_p8" android:duration="50"/> 
</animation-list> 

从 图 形 定义 文件 中 播放 帧 动画 的 效果 与 在 代码 中 添加 帧 图 片 是 一 样 的 ， 代 码 如 下 ; 

1/ 从 XML 文件 中 获取 帧 动画 并 进行 播放 

private void showFrameAnimByXml() { 
/ 设置 图 像 视 图 的 图 像 来 源 为 帧 动画 的 XML 定义 文件 
iv_frame_anim.setImageResource(R.drawable.frame_anim); 
/ 从 图 像 视图 对 象 中 获取 帧 动画 
ad frame = (AnimationDrawable) iv_frame anim.getDrawable(); 
ad_frame.start(); / 开始 播放 帧 动画 


12.1.2 显示 GIF 动画 


GIF 在 Windows 上 是 常见 的 图 片 格式 ， 主 要 用 来 播放 短小 的 动画 。Android 虽然 号 称 支持 
PNG、JPG、GIF 三 种 图 片 格式 ， 但 是 并 不 支持 直接 播放 GIF 动 图 ， 如 果 在 图 像 视图 中 加 载 一 
张 GIF 文件 ， 只 会 显示 GIF 文件 的 第 一 帧 图 片 。 

要 想 在 手机 上 显示 GIF 文件 ， 就 要 借助 于 帧 动画 技术 ， 具体 的 实现 方式 主要 有 以 下 两 种 : 


(1) 开发 者 在 电脑 上 把 GIF 文件 手工 分 解 为 一 组 帧 图 片 ， 放 入 工程 的 资源 目录 中 ， 再 通 
过 动画 图 形 显 示 帧 动画 。 
(2) 在 代码 中 将 GIF 文件 自动 分 解 为 一 系列 图 片 数 据 ， 并 获取 每 帧 的 持续 时 间 ， 然 后 通 
过 动画 图 形 动态 加 载 帧 图 片 。 该 方式 适合 播放 从 服务 器 获取 的 GIF 文件 。 
从 GIF 文件 中 分 解 帧 图 片 有 现成 的 开源 框架 代码 ， 具 体 参 见 本 书 附带 源码 animation 模块 
的 Giftmagejava， 以 及 GifActivity.java 里 面 的 showGifAnimationOld 方法 。 


上 述 两 种 显示 GIF 动 图 的 方法 显然 都 不 简单 ， 毕 竟 GIF 文件 还 是 很 流行 的 动 图 格式 ， 因 
而 Android 从 9.0 开始 增加 了 新 的 图 像 解 码 器 ImageDecoder, 该 解码 器 支持 直接 读 取 GIF 文件 
的 图 形 数据 , 通过 搭配 具备 动画 特征 的 图 形 工 具 Animatable, 即 可 轻松 实现 在 App 中 播放 GIF 


第 12 章 动画 | 537 





动 图 。 详 细 的 演示 代码 如 下 所 示 : 
Private void showGifAnimationNewO { 
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) f 
ty{ 
// 利用 Android 9.0 新 增 的 ImageDecoder 读 取 gif 图 片 
ImageDecoder.Source source = ImageDecoder.createSource( 
getResources(), R.drawable.welcome); 
// 从 数据 源 中 解码 得 到 gif 图 形 数据 
Drawable gifDrawable = ImageDecoder.decodeDrawable(source); 
/ 设置 图 像 视图 的 图 形 为 gif 图 片 
iv_gif.setImageDrawable(gifDrawable); 
// 如 果 是 动画 图 形 ， 则 开始 播放 动画 
if (gifDrawable instanceof Animatable) { 
((Animatable) iv_gif.getDrawableO).start(); 
了 
} catch (Exception e) { 
e.printStackTrace(); 
} 


GIF 文件 的 播放 效果 如 图 12-4 和 图 12-5 所 示 。 其 中 , 图 12-4 所 示 为 GIF 动 图 播放 开始 时 
的 画面 ， 图 12-5 所 示 为 GIF 动 图 临近 播放 结束 时 的 画面 。 











和 | Wn 在 


图 12-4 GIF 动画 开始 播放 图 12-5 ”GIF 动画 播放 结束 


上 面 提 到 Android 9.0 新 增 了 ImageDecoder， 该 图 像 解码 器 不 但 支持 播放 GIF 动 图 ， 也 支 
持 谷 歌 公司 自 研 的 WebP 图 片 。WebP 格式 是 谷歌 公司 在 2010 年 推出 的 新 一 代 图 片 格式 ， 它 
在 压缩 方面 比 JPEG 格式 更 高 效 ， 拥 有 相同 的 图 像 质 量 ，WebP 的 图 片 大 小 比 JPEG 图 片 平均 
要 小 30%。 另 外 ，WebP 还 支持 类 似 GIF 格式 那样 的 动 图 效果 ，ImageDecoder 从 WebP 图 片 读 
取出 Drawable 对 象 之 后 ， 即 可 转换 成 Animatable 实例 进行 动画 播放 和 停止 播放 的 操作 。 
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12.1.3” 淡 入 淡出 动画 


帧 动画 的 帧 显示 方式 采用 后 面 一 帧 直接 覆盖 前 面 一 帧 ， 这 在 快速 轮 播 时 没什么 问题 ， 但 
是 如 果 每 帧 的 间隔 时 间 比 较 长 〈 比 如 超过 0.5 秒 ) ， 两 帧 之 间 的 画面 切换 就 会 很 生硬 ， 直 接 从 
前 一 帧 变 成 后 一 帧 会 让 人 觉得 很 突 元 。 为 了 解决 这 种 长 间隔 切换 图 片 在 视觉 效果 方面 的 问题 ， 
Android 提供 了 过 渡 图 形 TransitionDrawable 处 理 两 张 图 片 之 间 的 渐变 显示 ， 即 淡 入 淡出 的 动 
画 效果 。 

过 渡 图 形 同 样 需要 宿主 视图 显示 该 图 形 ， 即 调用 ImageView 对 象 的 setImageDrawable 方 
法 进行 图 形 加 载 操作 。 下 面 是 TransitionDrawable 的 常用 方法 说 明 。 


构造 函数 : 指定 过 渡 图 形 的 图 形 数组 。 该 图 形 数组 大 小 为 2， 包含 前 后 两 张 图 形 。 
startTransition: 开始 过 渡 操 作 。 这 里 需要 先 设置 宿主 视图 ， 然 后 才能 进行 渐变 显示 。 
resetTransition: 重 置 过 渡 操 作 。 
reverseTransition: 倒 过 来 执行 过 渡 操 作 。 
下 面 是 使 用 过 渡 图 形 的 代码 片段 : 
/ 开始 播放 淡 入 淡出 动画 
private void showFadeAnimation() { 
// 淡 入 淡出 动画 需要 先 定义 一 个 图 形 资源 数组 ， 用 于 变换 图 片 
Drawable[] drawableArray = { 


getResources().getDrawable(R.drawable.fade_begin), 
getResources().getDrawable(R.drawable.fade_end) 


$s 

/ 创建 一 个 用 于 淡 入 淡出 动画 的 过 渡 图 形 

TransitionDrawable td_fade = new TransitionDrawable(drawableArray); 

/ 设置 图 像 视图 的 图 像 为 过 渡 图 形 

iv_fade_anim.setImageDrawable(td_fade); 

/ 开始 过 渡 图 形 的 变换 过 程 ， 其 中 变换 时 长 为 三 秒 

td_fade.startTransition(3000); 

} 
过 渡 图 形 的 播放 效果 如 图 12-6 和 图 12-7 所 示 。 其 中 ， 如 图 12-6 所 示 为 开始 转换 不 久 的 

画面 ， 此 时 仍 以 第 一 张 图 片 为 主 ， 如 图 12-7 所 示 为 转换 将 要 结束 的 画面 ， 此 时 已 经 基本 过 渡 
到 第 二 张 图 片 。 
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图 12-6 ” 淡 入 淡出 动画 开始 播放 图 12-7 淡 入 淡出 动画 即将 结束 
12.2 ” 补 间 动 画 


本 节 介 绍 补 间 动 画 的 原理 与 用 法 ， 首 先 指出 补 间 动 画 有 4 大 类 ， 分 别 是 灰 度 动画 、 平 移 
动画 、 缩 放 动画 和 旋转 动画 ， 介 绍 这 4 种 动画 的 基本 用 法 ; 接着 阐述 补 间 动 画 的 原理 ， 基 于 旋 
转动 画 的 思想 实现 摇摆 动画 ;然后 介绍 如 何 使 用 集合 动画 同时 展示 多 种 动画 效果 最 后 就 第 
11 章 的 飞 掠 横幅 遗留 问题 给 出 使 用 动画 技术 平滑 切换 前 后 视图 的 方案 。 


12.2.1 补 间 动 画 的 种 类 


12.1 节 提 到 两 张 图片 之 间 的 渐变 效果 可 以 使 用 过 渡 图 形 TransitionDrawable 实现 。 一 张 图 
形 内 部 能 和 否 运用 渐变 效果 ? 比如 对 图 片 的 大 小 进行 自动 缩放 等 。 正 好 ，Android 提供 了 补 间 动 
画 ， 允许 开 发 者 实现 某 个 视图 的 动态 变换 ， 具体 包括 4 类 动画 效果 ， 分 别 是 灰 度 动画 、 平 移动 
画 、 缩放 动画 和 旋转 动画 。 为 什么 把 这 4 种 动画 称 为 补 间 动 画 呢 ?” 因 为 由 开发 者 提供 动画 的 起 
始 状态 值 与 终止 状态 值 ， 然 后 系统 按照 时 间 推 移 计 算 中 间 的 状态 值 , 并 自动 把 中 间 状 态 的 视图 
补充 到 起 止 视图 中 ， 自 动 补充 中 间 视 图 的 动画 就 被 简称 为 “ 补 间 动 画 ”。 

补 间 动画 的 4 类 动画 ( 灰 度 动画 AlphaAnimation、 平 移动 画 TranslateAnimation、 缩 放 动 
画 ScaleAnimation 和 旋转 动画 RotateAnimation) 都 来 自 于 共同 的 动画 类 Animation， 因 此 同时 
拥有 Animation 的 属性 与 方法 。 下 面 是 Animation 的 常用 方法 说 明 。 


e@ setFillAfter: 设置 是 否 维持 结束 画面 。true 表示 动画 结束 后 停留 在 结束 画面 ，false 表 
示 动 画 结束 后 恢复 到 开始 画面 。 
e@ setRepeatMode : 设置 重播 模式 。 Animation RESTART 表示 从 头 开始 ， 
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Animation.REVERSE 表示 倒 过 来 开始 。 默认 为 Animation.RESTART。 

setRepeatCount: 设置 重播 次 数 。 默 认为 0 表示 只 播放 一 次 。 

setDuration: 设置 动画 的 持续 时 间 。 单 位 毫秒 。 

setInterpolator: 设置 动画 的 插值 器 。 

setAnimationListener: 设置 动画 事件 的 监听 器 . 需 实现 接口 AnimationListener 的 3 个 方法 。 


> onAnimationStart: 在 动画 开始 时 触发 。 
> onAnimationEnd: 在 动画 结束 时 触发 。 
> onAnimationRepeat: 在 动画 重播 时 触发 。 


与 帧 动画 一 样 ， 补 间 动 画 也 需要 找 一 个 宿主 视图 ， 对 宿主 视图 施展 动画 效果 。 不 同 的 是 ， 
帧 动画 的 宿主 视图 只 能 是 ImageView 相关 的 图 像 视 图 ， 而 补 间 动 画 的 宿主 视图 可 以 是 任意 视 
图 ， 只 要 派生 自 View 类 就 行 。 给 补 间 动画 指定 宿主 视图 的 方式 很 简单 ， 调 用 宿主 对 象 的 
startAnimation 方法 即 可 命令 宿主 视图 开始 动画 , 调用 宿主 对 象 的 clearAnimation 方法 即 可 要 求 
宿主 视图 清除 动画 。 

具体 到 每 种 补 间 动 画 又 有 不 同 的 初始 化 方式 。 下 面 来 看 具体 说 明 。 


(1) 初始 化 灰 度 动画 : 在 构造 函数 中 指定 视图 透明 度 的 前 后 数值 。 取 值 为 0.0 一 1.0，0 
表示 完全 不 透明 ，1 表示 完全 透明 。 

(2) 初始 化 平移 动画 ， 在 构造 函数 中 指定 视图 左上 角 在 平移 前 后 的 坐标 值 。 其 中 ， 第 一 
个 参数 为 平移 前 的 横 坐 标 , 第 二 个 参数 为 平移 后 的 横 坐 标 , 第 三 个 参数 为 平移 前 的 纵 坐标 , 第 
四 个 参数 为 平移 后 的 纵 坐 标 。 

(3) 初始 化 缩放 动画 : 在 构造 函数 中 指定 视图 横 纵 坐标 的 前 后 缩放 比例 。 缩 放 比例 取 值 
0.5 表示 缩小 到 原来 的 二 分 之 一 ， 取 值 2 表示 放大 到 原来 的 两 倍 。 其 中 ， 第 一 个 参数 为 缩放 前 
的 横 坐 标 比 例 ， 第 二 个 参数 为 缩放 后 的 横 坐标 比例 ， 第 三 个 参数 为 缩放 前 的 纵 坐 标 比 例 ， 第 四 
个 参数 为 缩放 后 的 纵 坐 标 比例 。 

(4) 初始 化 旋转 动画 : 在 构造 函数 中 指定 视图 的 旋转 角度 。 其 中 ， 第 一 个 参数 为 旋转 前 
的 角度 ， 第 二 个 参数 为 旋转 后 的 角度 ， 第 三 个 参数 为 圆心 的 横 坐 标 类 型 ， 第 四 个 参数 为 圆心 横 
坐标 的 数值 比例 ， 第 五 个 参数 为 圆心 的 纵 坐 标 类 型 ， 第 六 个 参数 为 圆心 纵 坐标 的 数值 比例 。 坐 
标 类 型 的 取 值 说 明 见 表 12-1。 





表 12-1 ”坐标 类 型 的 取 值 说 明 











Animation 类 的 坐标 类 型 说 明 
ABSOLUTE 绝对 位 置 
RELATIVE_TO_SELF 相对 自身 位 置 
RELATIVE_TO_PARENT 相对 上 级 位 置 


下 面 是 使 用 4 种 补 间 动 画 的 演示 代码 : 
public class TweenAnimActivity extends AppCompatActivity implements AnimationListener { 
Private Image View iv_tween_anim; / 声明 一 个 图 像 视图 对 和 象 
private Animation alphaAnim, translateAnim, scaleAnim, rotateAnim; / 声明 四 个 补 间 动 画 对 象 
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@Override 
protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_tween anim); 

// 从 布局 文件 中 获取 名 叫 iv_tween_anim 的 图 像 视图 
iv_tween_anim = findViewById(R.id.iv_tween anim); 
initAnimation0; / 初始 化 补 间 动 画 
initTweenSpinner(); 


// 初始 化 补 间 动 画 
private void initAnimation() { 


1 


/ 创建 一 个 灰 度 动画 。 从 完全 透明 变 为 即将 不 透明 

alphaAnim = new AlphaAnimation(1.0f, 0.1f); 

alphaAnim.setDuration(3000); / 设置 动画 的 播放 时 长 

alphaAnim.setFillAfter(true); / 设置 维持 结束 画面 

// 创建 一 个 平移 动画 。 向 左 平移 100dp 

translateAnim = new TranslateAnimation(1.0f Utils.dip2px(this, -100), 1.0£, 1.0f); 

translateAnim.setDuration(3000); / 设置 动画 的 播放 时 长 

translateAnim.setFillAfter(true); / 设置 维持 结束 画面 

/ 创建 一 个 缩放 动画 。 宽 度 不 变 ， 高 度 变 为 原来 的 二 分 之 一 

scaleAnim = new ScaleAnimation(1.0f, 1.0f, 1.0f, 0.5f); 

scaleAnim.setDuration(3000); / 设置 动画 的 播放 时 长 

scaleAnim.setFillAfter(true); / 设置 维持 结束 画面 

/ 创建 一 个 旋转 动画 。 围 绕 着 圆心 顺 时 针 旋转 360 度 

rotateAnim = new RotateAnimation(0f 360f Animation.RELATIVE_TO SELF, 
0.5f, Animation.RELATIVE_TO_SELF, 0.5); 

rotateAnim.setDuration(3000); /W 设置 动画 的 播放 时 长 

rotateAnim.setFillAfter(true); / 设置 维持 结束 画面 


// 初始 化 动画 类 型 下 拉 框 


Private void initTweenSpinner() { 


ArrayAdapter<String> tweenAdapter = new ArrayAdapter<String>(this, 
R.layout.item _select, tweenArray); 

Spinner sp_tween = findViewById(R.id.sp_tween); 

sp_tween.setPrompt(" 请 选择 补 间 动 画 类 型 "); 

sp_tween.setAdapter(tweenA dapter); 

sp_tween.setOnItemSelectedListener(new TweenSelectedListener()); 

sp_tween.setSelection(0); 
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private String[] tweenArray = {" 灰 度 动画 ", "平移 动画 ", "缩放 动画 ", "旋转 动画 "}; 
class TweenSelectedListener implements OnltemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
if(arg2 一 0){ 
/ 命令 图 像 视图 开始 播放 灰 度 动画 
iv_tween anim .startAnimation(alphaAnim); 
// 给 灰 度 动画 设置 动画 事件 监听 器 
alphaAnim.setAnimationListener(TweenAnimActivity.this); 
}elseif (arg2 — 1){ 
// 命令 图 像 视图 开始 播放 平移 动画 
iv_tween_anim.startAnimation(translate Anim); 
// 给 平移 动画 设置 动画 事件 监听 器 
translateAnim.setAnimationListener(TweenAnimActivity.this); 
} else if (arg2 — 2) { 
// 命令 图 像 视图 开始 播放 缩放 动画 
iv_tween_anim.startAnimation(scaleAnim); 
/ 给 缩放 动画 设置 动画 事件 监听 器 
scaleAnim.setAnimationListener(TweenAnimActivity.this); 
} else if (arg2 =— 3) { 
// 命令 图 像 视图 开始 播放 旋转 动画 
iv_tween_anim.startAnimation(rotateAnim); 
// 给 旋转 动画 设置 动画 事件 监听 器 


rotateAnim.setAnimationListener(TweenAnimActivity.this); 
} 


public void onNothingSelected(AdapterView<?> arg0) {} 


// 在 补 间 动 画 开始 播放 时 触发 
public void onAnimationStart(Animation animation) {} 


// 在 补 间 动 画 结束 播放 时 触发 
public void onAnimationEnd(Animation animation) { 
让 (animation.equals(alphaAnim)) { ”// 灰 度 动画 
// 创建 一 个 灰 度 动画 。 从 即将 不 透明 变 为 完全 透明 
Animation alphaAnim2 = new AlphaAnimation(0.18f 1.0f); 
alphaAnim2.setDuration(3000); / 设置 动画 的 播放 时 长 
alphaAnim2.setFillAfter(true); / 设置 维持 结束 画面 
// 命令 图 像 视图 开始 播放 灰 度 动画 
iv_tween_anim.startAnimation(alphaAnim2); 
}else 让 (animation.equals(translateAnim)){ / 平移 动画 
// 创建 一 个 平移 动画 。 向 右 平移 100dp 
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Animation translateAnim2 = new TranslateAnimation(Utils.dip2px(this, -100), 1.0f 1.0f 1.0f); 
translateAnim2.setDuration(3000); / 设置 动画 的 播放 时 长 
translateAnim2.setFillAfter(true); / 设置 维持 结束 画面 
// 命令 图 像 视图 开始 播放 平移 动画 
iv_tween anim.startAnimation(translateAnim2); 

} else if (animation.equals(scaleAnim)) { // 缩放 动画 
// 创建 一 个 缩放 动画 。 宽 度 不 变 ， 高 度 变 为 原来 的 两 倍 
Animation scaleAnim2 = new ScaleAnimation(1.0f, 1.0f 0.5f, 1.0f); 
scaleAnim2.setDuration(3000); / 设置 动画 的 播放 时 长 
scaleAnim2.setFilAfter(true); / 设置 维持 结束 画面 
// 命令 图 像 视图 开始 播放 缩放 动画 
iv_tween_anim.startAnimation(scaleAnim2); 

} elseif(animation.equals(rotateAnim)){ / 旋转 动画 
/ 创建 一 个 旋转 动画 。 围 绕 着 圆心 逆 时 针 旋 转 360 度 
Animation rotateAnim2 = new RotateAnimation(0f -360f, 

Animation.RELATIVE_ TO_SELF, 0.5f Animation.RELATIVE TO_SELE, 0.5f); 
rotateAnim2.setDuration(3000); / 设置 动画 的 播放 时 长 
rotateAnim2.setFillAfter(true); / 设置 维持 结束 画面 
// 命令 图 像 视图 开始 播放 旋转 动画 


iv_tween_anim.startAnimation(rotateAnim2); 
1 


// 在 补 间 动 画 重复 播放 时 触发 
public void onAnimationRepeat(Animation animation) {} 
| 


补 间 动 画 的 播放 效果 如 图 12-8 一 图 12-15 所 示 。 其 中 ， 图 12-8 和 图 12-9 所 示 为 灰 度 动画 
播放 前 后 的 画面 ， 图 12-10 和 图 12-11 所 示 为 平移 动画 播放 前 后 的 画面 ， 图 12-12 和 图 12-13 
所 示 为 缩放 动画 播放 前 后 的 画面 ， 图 12-14 和 图 12-15 所 示 为 旋转 动画 播放 前 后 的 画面 。 





补 间 动 画 类 型 ; 灰 度 动画 补 间 动 画 类 型 : 灰 度 动画 











图 12-8 ” 灰 度 动画 开始 播放 12-9” 灰 度 动画 即将 结束 
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补 间 动 画 类 型 : 平移 动画 | 补 间 动 画 类 型 : 平移 动画 











图 12-10 平移 动画 开始 播放 图 12-11 平移 动画 即将 结束 


补 间 动 画 类 型 ; 缩放 动画 补 间 动 画 类 型 : 缩放 动画 











图 12-12 缩放 动画 开始 播放 图 12-13 ”缩放 动画 即将 结束 





补 间 动 画 类 型 : 旋转 动画 补 间 动 画 类 型 : 旋转 动画 


12-14 ”旋转 动画 开始 播放 图 12-15 旋转 动画 正在 播放 


12.2.2 ” 补 间 动画 的 原理 














补 间 动 画 只 提供 了 基本 的 动态 变换 ， 如 果 想 要 复杂 的 动画 效果 ， 比 如 像 钟 摆 一 样 左 摆 一 
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下 再 右 摆 一 下 ,， 补 间 动 画 就 无 能 为 力 了 。 我 们 有 必要 了 解 补 间 动 画 的 实现 原理 ， 这样 才能 进行 
适当 的 改造 ， 使 其 符合 实际 的 业务 需求 。 
下 面 以 旋转 动画 RotateAnimation 为 例 说 明 补 间 动 画 的 实现 原理 。 查看 RotateAnimation 的 
源码 ， 发 现 除 了 一 堆 构 造 函 数 外 ， 剩 下 的 代码 只 有 3 个 函数 : 
private void initializePivotPointO { 
if (mPivotXType — ABSOLUTE) { 
mPivotX = mPivotXValue; 
} 
if (mPivotYType — ABSOLUTE) { 
mPivotY = mPivotY Value; 
} 
有 


@Override 

protected void applyTransformation(float interpolatedTime, Transformation t) { 
float degrees = mFromDegrees + ((mToDegrees - mFromDegrees) * interpolatedTime); 
float scale = getScaleFactor(); 


if (mPivotX == 0.0f && mpPivotY == 0.0D) { 
t.getMatrix().setRotate(degrees); 
}else{ 
t.getMatrix().setRotate(degrees, mPivotX * scale, mPivotY * scale); 
} 
b 


@Override 
public void initialize(int width, int height int parentWidth, int parentHeight) { 
Super.initialize( width, height, parentWidth, parentHeight); 
mPivotX = resolveSize(mPivotXType, mPivotX Value, width, parentWidth); 
mPivotY = resolveSize(mPivotY Type, mPivotY Value, height, parentHeight); 
注意 两 个 初始 化 函数 都 在 处 理 圆心 的 坐标 ， 实 际 与 动画 播放 有 关 的 代码 只 有 
applyTransformation 方法 。 该 方法 很 简单 ， 提 供 了 两 个 输入 参数 ， 第 一 个 参数 为 插值 时 间 ， 即 
逝去 的 时 间 所 占 的 百分比 , 第 二 个 参数 为 转换 器 。 方法 内 部 根据 插值 时 间 计 算 当 前 所 处 的 角度 
degrees， 最 后 使 用 转换 器 把 视图 旋转 到 该 角度 。 
查看 其 他 补 间 动 画 的 源码 ， 发 现 都 与 RotateAnimation 的 处 理 大 同 小 异 ， 对 中 间 状 态 的 视 
图 变换 处 理 不 外 乎 以 下 两 个 步骤 : 


CEI01 根据 插值 时 间 计算 当前 的 状态 值 (如 灰 度 、 距 离 、 比 率 、 角 度 等 ) 。 
人 02 在 宿主 视图 上 使 用 该 状态 值 进行 变换 操作 。 


如 此 看 来 ， 补 间 动 画 的 关键 在 于 利用 插值 时 间 计 算 状 态 值 。 现 在 回头 看 看 钟 摆 的 左右 摆 
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动 ， 这 个 摆动 操作 其 实 由 3 段 旋转 动画 构成 。 














(1) 以 上 面 的 端点 为 圆心 ， 钟 摆 以 垂直 向 下 的 状态 向 左旋 转 ， 转 到 左边 的 某 个 角度 停 住 


〈 比 如 左 转 60 度 ) 。 


(2) 钟 摆 从 左边 向 右边 旋转 ， 转 到 右边 的 某 个 角度 停 住 (比如 右 转 120 度 ， 与 重 直 方向 
的 夹 角 为 60 度 ) 。 
(3) 钟 摆 从 右边 再 向 左旋 转 ， 当 其 摆 到 重 直 方向 时 ， 完 成 一 个 周期 的 摇摆 动作 。 


弄 清楚 了 摇摆 动画 的 运动 过 程 ， 接 下 来 根据 插值 时 间 计 算 对 应 的 角度 。 具 体 到 代码 实现 





上 ， 需 要 做 以 下 两 处 调整 : 


(1) 旋转 动画 初始 化 时 只 有 两 个 度数 ， 即 起 始 角度 和 终止 角度 。 摇 摆动 画 需要 3 个 参数 ， 


即 中 间 有 角度 〈 既 是 起 始 角度 也 是 终止 角度 ) 、 摆 到 左 侧 的 角度 和 摆 到 右 侧 的 角度 。 


(2) 根据 插值 时 间 估算 当前 所 处 的 角度 。 对 于 摇摆 动画 来 说 ， 需 要 做 3 个 分 支 判断 〈 对 


应 之 前 3 段 旋转 动画 ) 。 如 果 整 个 动画 持续 4 秒 ， 那 么 0 一 1 秒 为 往 左 的 旋转 动画 ， 该 区 间 的 
起 始 角度 为 中 间 角 度 ， 终 止 角度 为 摆 到 左 侧 的 角度 ;1 一 3 秒 为 往 右 的 旋转 动画 ， 该 区 间 的 起 
始 角 度 为 摆 到 左 侧 的 角度 ， 终 止 角度 为 摆 到 右 侧 的 角度 ，3 一 4 秒 为 往 左 的 旋转 动画 ， 该 区 间 
的 起 始 角度 为 摆 到 右 侧 的 角度 ， 终 止 角度 为 中 间 角 度 。 

分 析 完 毕 ， 贴 上 修改 后 的 摇摆 动画 代码 片段 : 

// 在 动画 变换 过 程 中 调用 

@Override 

protected void applyTransformation(float interpolatedTime, Transformation t) { 


} 


float degrees; 
float leftPos = (float) (1.0 /4.0);， // 摆 到 左边 端点 时 的 时 间 比 例 
float rightPos = (float) (3.0 /4.0); / 摆 到 右边 端点 时 的 时 间 比 例 
if(interpolatedTime <= leftPos) { / 从 中 间 线 往 左 边 端点 摆 
degrees = mMiddleDegrees + ((mLeftDegrees - mMiddleDegrees) * interpolatedTime * 4); 
} else if (interpolatedTime > leftPos && interpolatedTime < rightPos) { / 从 左边 端点 往 右边 端点 摆 
degrees = mLeftDegrees + ((mRightDegrees - mLeftDegrees) * (interpolatedTime - leftPos) * 2); 
} else { // 从 右边 端点 往 中 间 线 摆 
degrees = mRightDegrees + ((mMiddleDegrees-mRightDegrees) * (interpolatedTime-rightPos)*4); 
1 
/ 获得 缩放 比率 
float scale = getScaleFactor(); 
if (mPivotX 一 0.0f && mpPivotY — 0.0f) { 
t.getMatrix().setRotate(degrees); 
}else{ 
t.getMatrix().setRotate(degrees, mPivotX * scale, mPivotY * scale); 
} 


摇摆 动画 的 播放 效果 如 图 12-16 和 图 12-17 所 示 。 其 中 ， 如 图 12-16 所 示 为 钟 摆 向 左 摆动 
时 的 画面 ， 如 图 12-17 所 示 为 钟 摆 向 右 摆动 时 的 画面 。 
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图 12-16 摇摆 动画 向 左 摆动 图 12-17 ”摇摆 动画 向 右 摆动 


12.2.3 ”集合 动画 


有 时 ， 一 个 动画 效果 会 揉 合 多 种 动画 技术 ， 比 如 一 边 旋转 、 一 边 缩放 用 到 集合 动画 
AnimationSet， 把 几 个 补 间 动 画 组 装 起 来 ， 实 现 让 某 视 图 同时 呈现 多 种 动画 的 效果 。 
集合 动画 与 补 间 动 画 一 样 继承 自 Animation 类 ， 所 以 拥有 补 间 动画 的 基本 方法 。 但 集合 动 
画 不 像 一 般 补 间 动 画 那样 提供 构造 函数 ， 而 是 通过 addAnimation 方法 把 别 的 补 间 动 画 加 入 本 
集合 动画 中 。 
下 面 是 使 用 集合 动画 的 代码 片段 : 
// 初始 化 集合 动画 
private void initAnimation() { 
/ 创建 一 个 灰 度 动画 
Animation alphaAnim = new AlphaAnimation( 1.0f, 0.19; 
alphaAnim.setDuration(3000); / 设置 动画 的 播放 时 长 
alphaAnim.setFillAfter(true); / 设置 维持 结束 画面 
// 创建 一 个 平移 动画 
Animation translateAnim = new TranslateAnimation( 1.0f, -200f, 1.0f, 1.0); 
translateAnim.setDuration(3000); / 设置 动画 的 播放 时 长 
translateAnim setFillAfter(true); // 设置 维持 结束 画面 
// 创建 一 个 缩放 动画 
Animation scaleAnim = new ScaleAnimation(1.0f, 1.0f 1.0f, 0.5f); 
scaleAnim.setDuration(3000); / 设置 动画 的 播放 时 长 
scaleAnim.setFillAfter(true); / 设置 维持 结束 画面 
// 创建 一 个 旋转 动画 
Animation rotateAnim = new RotateAnimation(Of, 360f, Animation.RELATIVE_TO_SELF, 
0.5f, Animation.RELATIVE_TO_SELE, 0.5D; 
rotateAnim.setDuration(3000); / 设置 动画 的 播放 时 长 
rotateAnim.setFillAfter(true); / 设置 维持 结束 画面 
// 创建 一 个 集合 动画 
setAnim = new AnimationSet(true); 
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/ 下 面 在 代码 中 添加 集合 动画 
setAnim addAnimation(alphaAnim); / 给 集合 动画 添加 灰 度 动画 
setAnim.addAnimation(translateAnim); // 给 集合 动画 添加 平移 动画 
setAnim .addAnimation(scaleAnim); / 给 集合 动画 添加 缩放 动画 
setAnim .addAnimation(rotateAnim); / 给 集合 动画 添加 旋转 动画 
setAnim.setFillAfter(true); / 设置 维持 结束 画面 
startAnim(); / 开始 播放 集合 动画 

} 


集合 动画 的 播放 效果 如 图 12-18 和 图 12-19 所 示 。 其 中 ， 如 图 12-18 所 示 为 集合 动画 开始 
不 久 的 画面 ， 如 图 12-19 所 示 为 集合 动画 即将 结束 的 画面 。 


animation animation 


12-18 ”集合 动画 开始 播放 不 久 图 12-19 集合 动画 即将 结束 播放 


帧 动画 允许 在 XML 文件 中 存放 动画 定义 ， 补 间 动 画 也 允许 ， 就 连 集合 动画 都 可 以 放 在 一 
块 描述 。 下 面 是 一 个 集合 动画 的 XML 文件 定义 的 例子 ， 其 中 包含 4 个 补 间 动 画 定义 : 
<!-- set 标记 表示 下 面 定义 的 是 集合 动画 --> 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- alpha 标记 表示 下 面 定义 的 是 灰 度 动画 -> 
<alpha android:duration="3000" android:fromAlpha="1.0" android:toAlpha="0.1" 伺 
<!-- translate 标记 表示 下 面 定义 的 是 平移 动画 --> 
<translate android:duration="3000" android:fromXDelta="1.0" 
android:toXDelta="-200" android:fromY Delta="1.0" android:toYDelta="1.0" /> 
<!-- scale 标记 表示 下 面 定义 的 是 缩放 动画 -> 
<scale android:duration="3000" android:fromXScale="1.0” android:toXScale="1.0" 
android:fromYScale="1.0” android:toYScale="0.5" /> 
<!--rotate 标记 表示 下 面 定义 的 是 旋转 动画 --> 
<rotate android:duration="3000” android:fromDegrees="0" android:toDegrees="360" 
android:pivotX="50%" android:pivotY="50%" /> 
</set> 


在 代码 中 调用 动画 工具 AnimationUtils 的 loadAnimation 方法 ， 即 可 加 载 该 集合 动画 的 文 
件 定义 ， 无 须 在 代码 中 定义 其 他 4 种 补 间 动 画 。 具 体 加 载 代 码 如 下 : 
// 下 面 从 XML 文件 中 获取 集合 动画 
setAnim.addAnimation(AnimationUtils.loadAnimation(this, Ranim.anim set)); 


使 用 上 述 XML 文件 演示 集合 动画 的 效果 如 图 12-18 和 图 12-19 所 示 ， 画 面 效果 与 代码 定 
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义 方式 没什么 区 别 。 
12.2.4 在 飞 掠 横幅 中 使 用 补 间 动 画 





第 11 章 介 绍 飞 掠 视图 ViewFlipper 时 ， 结 合 手势 检测 器 GestureDetector 实现 了 飞 掠 横 幅 
的 效果 。 不 过 前 后 Banner 的 飞 掠 切换 有 些 生硬 ， 后 面 的 广告 图 一 下 子 把 前 面 的 广告 图 覆盖 ， 
显得 十 分 突 巨 ,完全 不 如 ViewPager 那样 翻 页 自然 。 现 在 我 们 正好 活 学 活用 ， 试 试 利用 补 间 动 
画 技术 给 飞 掠 横 幅 加 上 动画 翻 页 变换 ， 看 看 能 否 达到 自然 翻 页 的 预期 效果 。 

第 11 章 提 到 ，ViewFlipper 有 以 下 4 个 操作 动画 的 方法 : 


setInAnimation: 设置 视图 的 移入 动画 。 
getInAnimation: 获取 移入 动画 的 动画 对 象 。 
setOutAnimation: 设置 视图 的 移出 动画 。 
getOutAnimation: 获取 移出 动画 的 动画 对 象 。 
通过 这 4 个 动画 方法 加 载 动画 定义 ， 应 该 能 实现 飞 掠 视图 前 后 切换 的 动画 效果 。 
首先 定义 几 个 动画 定义 文件 ， 用 来 描述 移入 动画 和 移出 动画 的 行为 。 具 体 地 说 ， 包 括 4 
个 动画 定义 文件 : 向 左 移入 动画 、 向 左 移出 动画 、 向 右 移 入 动画 和 向 右 移出 动画 。 下 面 对 这 4 
个 动画 定义 文件 分 别 进行 说 明 。 
(1) 向 左 移入 动画 ， 用 来 描述 Banner 向 左 翻 页 时 右边 页 面 的 移入 行为 ， 动 画 文件 名 为 
push_left_in.xml， 文 件 内 容 如 下 : 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
<translate android:duration="1500" android:fromXDelta="100.0%p" android:toXDelta="0.0" /> 
<alpha android:duration="1500" android:fromAlpha="0.1” android:toAlpha="1.0" 这 
</set> 


(2) 向 左 移出 动画 ， 用 来 描述 Banner 向 左 翻 页 时 左边 页 面 的 移出 行为 ， 动 画 文 件 名 为 
push_left_out.xml， 文 件 内 容 如 下 : 


<set xmlns:android="http://schemas.android.com/apk/res/android"> 
<translate android:duration="1500” android:fromXDelta="0.0" android:toXDelta="-100.0%p" 广 
<alpha android:duration="1500" android:fromAlpha="1.0" android:toAlpha="0.1" /> 
</set> 
(3) 向 右 移入 动画 ， 用 来 描述 Banner 向 右 翻 页 时 左边 页 面 的 移入 行为 ， 动 画 文件 名 为 
push_right_in.xml， 文 件 内 容 如 下 : 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
<translate android:duration="1500" android:fromXDelta="-100.0%p" android:toXDelta="0.0" /> 
<alpha android:duration="1500" android:fromAlpha="0.1" android:toAlpha="1.0" 伺 
</set> 
(4) 向 右 移 出 动画 ， 用 来 描述 Banner 向 右 翻 页 时 右边 页 面 的 移出 行为 ， 动 画 文件 名 为 
push_right_out.xml， 文 件 内 容 如 下 : 
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<set xmlns:android="http://schemas.android.com/apk/res/android"> 
<translate android:duration="1500" android:fromXDelta="0.0" android:toXDelta="100.0%p" /> 
<alpha android:duration="1500" android:fromAlpha="1.0" android:toAlpha="0.1" 亡 

</set> 


在 第 11 章 的 BannerFlipper 代码 中 补充 以 下 片段 ， 加 载 相关 动画 定义 文件 ， 并 在 翻 页 时 展 
示 动 画 : 

/ 播放 下 一 个 场景 

public void startFlip() { 
mFlipper.startFlipping(); / 开始 轮 播 
1/ 设置 飞 掠 视图 的 淡 入 动画 
mFlipper.setInAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push_left_in)); 
/ 设置 飞 掠 视图 的 淡出 动画 
mFlipper.setOutAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push_left_out)); 
/ 设置 飞 掠 视图 淡出 动画 的 动画 事件 监听 器 
mFlipper.getOutAnimation().setAnimationListener(new BannerAnimationListener()); 
mFlipper.showNext0; / 显示 下 一 个 场景 

bi 


/ 播放 上 一 个 场景 

public void backFlip() { 
mFlipper.startFlipping(); / 开始 轮 播 
/ 设置 飞 掠 视图 的 淡 入 动画 
mFlipper.setInAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push_right_in)); 
/ 设置 飞 掠 视图 的 淡出 动画 
mFlipper.setOutAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push_right_out)); 
/ 设置 飞 掠 视图 淡出 动画 的 动画 事件 监听 器 
mFlipper.getOutAnimation().setAnimationListener(new BannerAnimationListener()); 
mFlipper.showPrevious(); / 显示 上 一 个 场景 
/ 设置 飞 掠 视图 的 淡 入 动画 
mFlipper.setInAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push_left_in)); 
/ 设置 飞 掠 视图 的 淡出 动画 
mFlipper.setOutAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push_left_out)); 
/ 设置 飞 掠 视图 淡出 动画 的 动画 事件 监听 器 
mFlipper.getOutAnimation().setAnimationListener(new BannerAnimationListener()); 

} 


// 定义 一 个 飞 掠 动画 监听 器 

private class BannerAnimationListener implements Animation.AnimationListener { 
// 在 补 间 动 画 开始 播放 时 触发 
public final void onAnimationStart(Animation animation) {} 


/ 在 补 间 动画 结束 播放 时 触发 
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public final void onAnimationEnd(Animation animation) { 

/ 获得 正在 播放 的 场景 位 置 

int position = mFlipper.getDisplayedChild(); 

/ 根据 场景 位 置 ， 设 置 当前 的 高 亮 指 示 圆 点 

((RadioButton) mGroup.getChildAt(position)).setChecked(true); 
b 


/ 在 补 间 动 画 重 复 播放 时 触发 
public final void onAnimationRepeat(Animation animation) {} 
改造 后 的 飞 掠 横幅 在 翻 页 时 的 动画 效果 如 图 12-20 和 图 12-21 所 示 。 其 中 ， 如 图 12-20 所 
示 为 向 左 翻 页 开始 不 久 的 画面 ,右边 页 面 逐 步 移 入 且 色 彩 渐渐 淡 入 ; 如 图 12-21 所 示 为 向 左 翻 
页 即将 结束 时 的 画面 ， 左 边 页 面 逐 步 移出 且 色 彩 渐渐 淡出 。 


EE animation 


信用 卡 还 款 


柄 有形 好 礼 等 你 来 


1 0 元 还 职 多 /99 职 分 





12-20 ” 飞 掠 横幅 开始 向 左 翻 页 图 12-21 飞 掠 横幅 左 翻 即将 结束 


读者 是 否 注意 到 , 集成 了 动画 效果 的 飞 掠 横幅 与 第 7 章 的 横幅 轮 播 Banner 竞 有 几 分 相似 。 
采用 不 同 技术 实现 的 效果 殊途同归 ， 这 正 是 Android 开发 的 魅力 所 在 。 


12.3 属性 动画 


本 节 介 绍 属性 动画 的 应 用 场合 与 进 阶 用 法 ， 首 先 说 明 为 何 属性 动画 是 补 间 动 画 的 升级 版 ， 
以 及 属性 动画 的 基本 用 法 ;接着 说 明 如 何 运用 属性 动画 组 合 实现 多 个 属性 动画 的 同时 播放 与 顺 
序 播放 效果 最 后 对 动画 技术 中 的 插值 器 和 估 值 器 进行 分 析 ， 并 演示 不 同 插值 器 的 动画 效果 。 


12.3.1 属性 动画 的 用 法 


视图 View 有 许多 状态 属性 ，4 种 补 间 动画 只 对 其 中 6 种 属性 进行 操作 ， 这 6 种 属性 的 说 
明 见 表 12-2。 
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表 12-2 ” 补 间 动 画 的 属性 说 明 
View 类 的 属性 名 称 属性 说 明 属性 设置 方法 对 应 的 补 间 动 画 
alpha 透明 度 setAlpha 灰 度 动 画 
rotation | 旋转 角度 setRotation | 旋转 动画 
scaleX | 横 坐 标的 缩放 比例 setScaleX | 缩放 动画 
scaleY | 纵 坐 标的 缩放 比例 setScaleY | 缩放 动画 
translationX | 横 坐 标的 平移 距离 setTranslationX | 平移 动画 
translationY 纵 坐标 的 平移 距离 setTranslationY 平移 动画 





可 是 每 个 控件 的 属性 远 不 止 这 6 种 ， 如 果 要 求 对 视图 的 背景 颜色 做 渐变 处 理 ， 补 间 动 画 
就 无 能 为 力 了 。 为 此 ，Android 自 3.0 后 引入 了 属性 动画 ObjectAnimator， 属 性 动画 突破 了 补 
间 动 画 的 局 限 ， 允 许 视图 的 所 有 属性 都 能 实现 渐变 的 动画 效果 ,例如 背景 颜色 、 文 字 颜 色 、 文 
字 大 小 等 。 只 要 设 定 某 属性 的 起 始 值 与 终止 值 、 渐变 的 持续 时 间 , 属性 动画 即 可 实现 该 属性 的 
动画 渐变 效果 。 

下 面 是 ObjectAnimator 的 常用 方法 。 


四 
四 
四 
. 


ofInt: 定义 整 型 属性 的 属性 动画 。 

ofFloat: 定义 浮 点 型 属性 的 属性 动画 。 

ofArgb: 定义 颜色 属性 的 属性 动画 。 

ofObject: 定义 对 象 属性 的 属性 动画 。 用 于 不 是 上 述 三 种 类 型 的 属性 , 例如 Rect 对 象 。 


以 上 4 个 of 方法 的 第 一 个 参数 为 宿主 视图 对 象 ， 第 二 个 参数 为 需要 变化 的 属性 名 称 ， 第 
三 个 参数 后 为 属性 变化 的 各 个 状态 值 。 注 意 ，of 方法 后 面 的 参数 个 数 是 变化 的 。 如 果 第 3 个 
参数 是 状态 A， 第 4 个 参数 是 状态 B， 属 性 动画 就 从 A 状态 变 为 B 状态 ， 如 果 第 3 个 参数 是 
状态 A， 第 4 个 参数 是 状态 B， 第 5 个 参数 是 状态 C， 属 性 动画 就 先 从 A 状态 变 为 B 状态 ， 


再 从 B 状态 变 为 C 状态 。 
e@ setRepeatMode: 设置 重播 模式 。ValueAnimatorRESTART 表示 从 头 开 始 ， 


ValueAnimator.REVERSE 表示 倒 过 来 开始 。 默 认为 ValueAnimator.RESTART。 
setRepeatCount: 设置 重播 次 数 。 默 认为 0 表示 只 播放 一 次 。 

setDuration: 设置 动画 的 持续 时 间 。 单 位 毫秒 。 

setInterpolator: 设置 动画 的 插值 器 。 

setEvaluator: 设置 动画 的 估 值 器 。 

start: 开始 播放 动画 。 

cancel: 取消 播放 动画 。 

end: 结束 播放 动画 。 

pause: 暂停 播放 动画 。 

resume: 恢复 播放 动画 。 

reverse: 倒 过 来 播放 动画 。 

isRunning: 判断 动画 是 否 在 播放 。 注 意 ， 暂 停 时 ，isRunning 方法 仍然 返回 true。 
isPaused: 判断 动画 是 否 被 暂停 。 
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对 象 


isStarted: 判断 动画 是 否 已 经 开始 。 注 意 ， 曾 经 播放 与 正在 播放 都 算 已 经 开始 。 
addListener: 添加 动画 监听 器 ， 需 实现 接口 AnimatorListener 的 4 个 方法 。 

> onAnimationStart: 在 动画 开始 播放 时 触发 。 

> onAnimationEnd: 在 动画 结束 播放 时 触发 。 

> onAnimationCancel: 在 动画 取消 播放 时 触发 。 

> onAnimationRepeat: 在 动画 重播 时 触发 。 

removeListener: 移出 指定 的 动画 监听 器 。 

removeAllListeners: 移出 所 有 动画 监听 器 。 


下 面 是 使 用 属性 动画 的 代码 : 


public class ObjectAnimActivity extends AppCompatActivity { 


private ImageView iv_object_anim; / 声明 一 个 图 像 视图 对 象 


private ObjectAnimator alphaAnim, translateAnim, scaleAnim, rotateAnim; /分 别 声明 4 个 属性 动画 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_object_anim); 
/ 从 布局 文件 中 获取 名 叫 iv_object_anim 的 图 像 视图 
iv_object_anim = findViewById(R.id.iv_object_anim); 
initAnimator0; / 初始 化 属性 动画 
initObjectSpinner(); 

) 


/ 初始 化 属性 动画 

private void initAnimator() { 
/ 构造 一 个 在 透明 度 上 变化 的 属性 动画 
alphaAnim = ObjectAnimator.ofFloat(iv_object_anim, "alpha", 1f, 0.1f, 1f); 
/ 构造 一 个 在 横 轴 上 平移 的 属性 动画 


translateAnim = ObjectAnimator.ofFloat(iv_object_anim, "translationX", 0f -200f, Of, 200f, 0f); 


/ 构造 一 个 在 纵 轴 上 缩放 的 属性 动画 

scaleAnim = ObjectAnimatorofFloat(iv_object_anim, "scaleY", 1f, 0.5f, 1f); 

/ 构造 一 个 围绕 中 心 点 旋转 的 属性 动画 

rotate Anim = ObjectAnimator.ofFloat(iv_object_anim, "rotation", 0f 360f, 0f); 
上 


/ 初始 化 动画 类 型 下 拉 框 
private void initObjectSpinner() { 
ArrayAdapter<String> objectAdapter = new ArrayAdapter<String>(this, 
R.layout.item select, objectArray); 
Spinner sp_object = findViewByld(R.id.sp_object); 
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sp_object.setPrompt(" 请 选择 属性 动画 类 型 "); 
sp_object.setAdapter(objectA dapter); 
sp_object.setOnItemSelectedListener(new ObjectSelectedListener()); 
sp_object.setSelection(0); 





private String[] objectArray = {" 灰 度 动画 ", "平移 动画 ", "缩放 动画 ", "旋转 动画 ", "裁剪 动画 "}; 


class ObjectSelectedListener implements OnltemSelectedListener { 
public void onItemSelected( AdapterView<?> arg0, View argl, int arg2, long arg3) { 
showAnimation(arg2); / 显示 指定 类 型 的 属性 动画 


public void onNothingSelected(AdapterView<?> arg0) {} 


@TargetApi(Build.VERSION CODESJELLY BEAN_MR2) 
/ 显示 指定 类 型 的 属性 动画 
private void showAnimation(int type) { 
ObjectAnimator anim = null; 
让 (type ==0) { // 灰 度 动画 
anim = alphaAnim; 
} else if (type ==1) { // 平移 动画 
anim = translateAnim; 
} else if (type ==2) { // 缩放 动画 
anim = scaleAnim; 
} else if (type ==3) { // 旋转 动画 
anim = rotate Anim; 
} else if (type ==4) { // 裁 前 动画 
if (Build.VERSION.SDK_INT < Build.VERSION_ CODES.JELLY BEAN_MR2) { 
Toast.makeText(this, "矩形 估 值 器 需要 Android4.3 及 以 上 版 本 "， 
Toast.LENGTH_SHORT).showO; 
return; 
} 
int width = iv_object_anim.getWidth(); 
int height = iv_object_anim.getHeight(); 
// 构造 一 个 从 四 周 向 中 间 裁 剪 的 属性 动画 
ObjectAnimator clipAnim = ObjectAnimator.ofObject(iv_object_anim, "clipBounds", 
new RectEvaluator(), new Rect(0, 0, width, height), 
new Rect(width / 3, height / 3, width / 3 * 2, height / 3 * 2), 
new Rect(0, 0, width, height)); 
anim = clipAnim; 
} 
if (anim !=nulD) { 
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anim.setDuration(3000); 人 设置 动画 的 播放 时 长 
anim.start(); / 开始 播放 属性 动画 


} 

在 上 述 代码 演示 的 属性 动画 中 ， 补 间 动 画 已 经 实现 的 效果 就 不 再 给 出 图 示 了 ， 补 间 动 画 
未 实现 的 裁剪 动画 效果 如 图 12-22 和 图 12-23 所 示 。 其 中 ， 如 图 12-22 所 示 为 裁剪 即将 开始 时 
的 画面 ， 如 图 12-23 所 示 为 裁剪 过 程 中 的 画面 。 




















EU 








图 12-22 ”裁剪 动画 即将 开始 图 12-23 ”裁剪 动画 正在 播放 
12.3.2 ”属性 动画 组 合 


补 间 动 画 可 以 通过 集合 动画 AnimationSet 组 装 多 种 动画 效果 ， 属 性 动画 也 有 类 似 的 做 法 ， 
即 通过 属性 动画 组 合 AnimatorSet 组 装 多 种 属性 动画 。 
AnimatorSet 虽然 与 ObjectAnimator 都 是 继承 自 Animator, 但 是 两 者 的 使 用 方法 略 有 出 入 ， 
主要 是 属性 动画 组 合 少 了 部 分 方法 。 下 面 是 AnimatorSet 的 常用 方法 。 
e@ setDuration: 设置 动画 组 合 的 持续 时 间 。 单 位 毫秒 。 
@ setInterpolator: 设置 动画 组 合 的 插值 器 。 
e@ play: 设置 当前 动画 。 该 方法 返回 一 个 AnimatorSet.Builder 对 象 ， 可 对 该 对 象 调用 组 
装 方法 添加 新 动画 ， 从 而 实现 动画 组 装 功能 。 下 面 是 Builder 的 组 装 方法 说 明 。 
> with: 指定 该 动画 与 当前 动画 一 起 播放 。 
> before: 指定 该 动画 在 当前 动画 之 前 播放 。 
> after: 指定 该 动画 在 当前 动画 之 后 播放 。 
start: 开始 播放 动画 组 合 。 
pause: 暂停 播放 动画 组 合 。 
resume: 恢复 播放 动画 组 合 。 
cancel: 取消 播放 动画 组 合 。 
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e@ end: 结束 播放 动画 组 合 。 
e isRunning: 判断 动画 组 合 是 否 在 播放 。 
e@ isStarted: 判断 动画 组 合 是 否 已 经 开始 。 


下 面 是 使 用 属性 动画 组 合 的 代码 : 


// 初始 化 属性 动画 
private void initAnimator() { 
/ 构造 一 个 在 横 轴 上 平移 的 属性 动画 
ObjectAnimator animl = ObjectAnimator.ofFloat(iv_object_group, "translationX", 0f 100f); 
/ 构造 一 个 在 透明 度 上 变化 的 属性 动画 
ObjectAnimator anim2 = ObjectAnimator.ofFloat(iv_object_group, "alpha", 1f, 0.1f, 1£, 0.5f, 1f); 
/ 构造 一 个 围绕 中 心 点 旋转 的 属性 动画 
ObjectAnimator anim3 = ObjectAnimator.ofFloat(iv_object_group, "rotation", 0f 360f); 
/ 构造 一 个 在 纵 轴 上 缩放 的 属性 动画 
ObjectAnimator anim4 = ObjectAnimator.ofFloat(iv_object_group, "scaleY", 1f 0.5f, 1f); 
/ 构造 一 个 在 横 轴 上 平移 的 属性 动画 
ObjectAnimator anims = ObjectAnimator.ofFloat(iv_object_group, "translationX", 100f, 0f); 
/ 创建 一 个 属性 动画 组 合 
AnimatorSet animSet = new AnimatorSet(); 
/ 把 指定 的 属性 动画 添加 到 属性 动画 组 合 
AnimatorSet.Builder builder = animSetplay(anim2); 
/ 动画 播放 顺序 为 ，animl 先 执行 ， 然 后 再 一 起 执行 anim2、anim3、anim3， 最 后 执行 anim5 
builder with(anim3).with(anim4).after(anim1).before(animS); 
animSetsetDuration(4500); / 设置 动画 的 播放 时 长 
animSet.start()， / 开始 播放 属性 动画 
) 


属性 动画 组 合 的 演示 效果 如 图 12-24 和 图 12-25 所 示 。 其 中 ， 如 图 12-24 所 示 为 动画 组 合 
开始 播放 不 久 的 画面 ， 如 图 12-25 所 示 为 动画 组 合 播放 过 程 中 的 画面 。 











12-24 ”属性 动画 组 合 开始 播放 图 12-25 属性 动画 组 合 正在 播放 
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12.3.3 ”插值 器 和 估 值 器 


前 面 在 介绍 补 间 动 画 与 属性 动画 时 提 到 了 插值 器 ， 属 性 动画 还 提 到 了 估 值 器 ， 因 为 插值 
器 和 估 值 器 是 相互 关联 的 ， 所 以 放 到 一 起 介绍 。 

插值 器 用 来 控制 属性 值 的 变化 速率 ， 也 可 以 理解 为 动画 播放 的 速度 ， 默 认 是 匀速 播放 。 
要 给 动画 播放 指定 某 种 速率 形式 ， 调 用 setInterpolator 方法 设置 对 应 的 插值 器 实现 类 即 可 ， 无 
论 是 补 间 动画 、 集 合 动 画 、 属 性 动画 ,还 是 属性 动画 组 合 ,都 可 以 设置 插值 器 。 插 值 器 实现 类 
的 说 明 见 表 12-3。 


表 12-3 ”插值 器 实现 类 的 说 明 

















插值 器 的 实现 类 说 明 

LinearInterpolator 匀速 插值 器 

AccelerateInterpolator 加 速 插值 器 

DecelerateInterpolator 减速 插值 器 

AccelerateDecelerateInterpolator | 落水 插值 器 ， 即 前 半 段 加 速 、 后 半 段 减速 

AnticipateInterpolator 射箭 插值 器 ， 后 退 几 步 再 往 前 冲 

OvershootInterpolator 回旋 插值 器 ， 冲 过 头 再 归 位 

AnticipateOvershootInterpolator | 射箭 回旋 插值 器 ， 后 退 几 步 再 往 前 冲 ， 冲 过 头 再 归 位 

BounceInterpolator 震荡 插值 器 ， 类 似 皮球 落地 (落地 后 会 弹 起 几 次 ) 

CycleInterpolator 钟 摆 插值 器 ， 以 开始 位 置 为 中 线 而 晃动 〈 类 似 摇 摆动 画 ， 开 始 位 置 与 结 
束 位 置 的 距离 就 是 摇摆 的 幅度 ) 


估 值 器 专用 于 属性 动画 ， 主 要 描述 该 属性 的 数值 变化 要 采用 什么 单位 ， 比 如 整 型 数 的 渐 
变数 值 要 取 整 ， 颜 色 的 渐变 数值 为 ARGB 格式 的 颜色 对 象 ， 和 矩形 的 渐变 数值 为 Rect 对 象 等 。 
要 给 属性 动画 设置 估 值 器 ， 调 用 属性 动画 对 象 的 setEvaluator 方法 即 可 。 估 值 器 实现 类 的 说 明 
见 表 12-4。 


表 12-4 ” 估 值 器 实现 类 的 说 明 














估 值 器 的 实现 类 说 明 
IntEvaluator 整 型 估 值 器 
FloatEvaluator 浮 点 型 估 值 器 
ArgbEvaluator 颜色 估 值 器 
RectEvaluator 和 矩形 估 值 器 





- 般 情 况 下 ， 无 须 单独 设置 属性 动画 的 估 值 器 ， 使 用 系统 默认 的 估 值 器 即 可 。 但 是 如 果 
属性 类 型 不 是 int、float、argb 三 种 ， 只 能 通过 ofObject 方法 构造 属性 动画 对 象 ， 就 必须 指定 
该 属性 的 估 值 器 , 否则 系统 不 知道 如 何 计算 渐变 属性 值 。 为 方便 记忆 属性 动画 的 构造 方法 与 估 
值 器 的 关联 关系 ， 表 12-5 列 出 了 两 者 之 间 的 对 应 关系 。 
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表 12-5 ”属性 类 型 与 估 值 器 的 对 应 关系 




















属性 动画 的 构造 方法 “| 估 值 器 对 应 的 属性 说 明 

ofInt IntEvaluator 整 型 类 型 的 属性 

ofFloat FloatEvaluator | 大 部 分 状态 属性 ， 如 alpha、rotation、scaleY、translationX、textSize 等 
ofArgb ArgbEvaluator | 颜色 ， 如 backgroundColor、textColor 等 

ofObject RectEvaluator | 裁剪 范围 ， 如 clipBounds 





下 面 是 在 属性 动画 中 运用 插值 器 和 估 值 器 的 代码 : 
public class InterpolatorActivity extends AppCompatActivity implements AnimatorListener { 


Private TextView tv_interpolator， // 声明 一 个 图 像 视图 对 象 
private ObjectAnimator animAcce, animDece, animLinear, animBounce; // 声明 4 个 属性 动画 对 象 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_interpolator); 
// 从 布局 文件 中 获取 名 叫 tv_interpolator 的 图 像 视图 
tv_interpolator = findViewById(R.id.tv_interpolator); 
initAnimator0; / 初始 化 属性 动画 
initInterpolatorSpinner(); 

1 


/ 初始 化 插值 器 类 型 的 下 拉 框 

private void initInterpolatorSpinner() { 
ArrayAdapter<String> interpolatorAdapter = new ArrayAdapter<String>(this, 

R.layout.item_select, interpolatorArray); 

Spinner sp_interpolator = findViewById(R.id.sp_interpolator); 
sp_interpolator.setPrompt(" 请 选择 插值 器 类 型 "); 
sp_interpolator.setA dapter(interpolatorA dapter); 
sp_interpolator.setOnItemSelectedListener(new InterpolatorSelectedListener()); 
Sp_interpolator setSelection(0); 


private String[] interpolatorArray = { 
"背景 色 + 加 速 插值 器 + 颜色 估 值 器 ", "旋转 + 减速 插值 器 + 浮 点 型 估 值 器 "， 
"裁剪 + 匀速 插值 器 + 矩形 估 值 器 ", "文字 大 小 + 震荡 插值 器 + 浮 点 型 估 值 器 "}; 
class InterpolatorSelectedListener implements OnItemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
showInterpolator(arg2); / 根据 插值 器 类 型 展示 属性 动画 


public void onNothingSelected(AdapterView<?> arg0) {} 
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出 


/ 初始 化 属性 动画 
private void initAnimator() { 


} 


/ 构造 一 个 在 背景 色 上 变化 的 属性 动画 

animAcce = ObjectAnimator.ofInt(tv_interpolator "backgroundColor", Color.RED, ColorGRAY); 
/ 给 属性 动画 设置 加 速 插值 器 

animAcce.setInterpolator(new AccelerateInterpolator()); 

/ 给 属性 动画 设置 颜色 估 值 器 

animAcce.setEvaluator(new ArgbEvaluator()); 

// 构造 一 个 围绕 中 心 点 旋转 的 属性 动画 

animDece = ObjectAnimator.ofFloat(tv_interpolator, "rotation", 0f 360f); 

/ 给 属性 动画 设置 减速 插值 器 

animDece.setInterpolator(new DecelerateInterpolator()); 

/ 给 属性 动画 设置 浮 点 型 估 值 器 

animDece.setEvaluator(new FloatEvaluator()); 

/ 构造 一 个 在 文字 大 小 上 变化 的 属性 动画 

animBounce = ObjectAnimatorofFloat(tv_interpolator "textSize", 20f 60f); 
/ 给 属性 动画 设置 震荡 插值 器 

animBounce.setInterpolator(new BounceInterpolatorO); 

/ 给 属性 动画 设置 浮 点 型 估 值 器 


animBounce.setEvaluator(new FloatEvaluator()); 


/ 根据 插值 器 类 型 展示 属性 动画 
private void showInterpolator(int type) { 


ObjectAnimator anim = null; 
证 (type ==0) { // 背景 色 + 加 速 插值 器 + 颜色 估 值 器 
anim = animAcce; 
} else if (type ==1) { / 旋转 + 减速 插值 器 + 浮 点 型 估 值 器 
anim = animDece; 
} else if (type ==2) { // 裁剪 + 匀速 插值 器 + 矩形 估 值 器 
让 (Build.VERSION.SDK_ INT < Build.VERSION CODES.JELLY BEAN MR2){ 
Toast.makeText(this, "和 矩形 估 值 器 需要 Android4.3 及 以 上 版 本 ", 
ToastLENGTH_ SHORT).show0; 
Teturn; 
} 
int width = tv_interpolator.getWidth(); 
int height = tv_interpolator.getHeight(); 
// 构造 一 个 从 四 周 向 中 间 裁 剪 的 属性 动画 ， 同 时 指定 了 甜 形 估 值 器 RectEvaluator 
animLinear = ObjectAnimatorofObject(tv_interpolator "clipBounds", 
new RectEvaluator(), new Rect(0, 0, width, height), 
new Rect(width / 3, height / 3, width / 3 * 2, height / 3 * 2), 
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new Rect(0, 0, width, height)); 

// 给 属性 动画 设置 匀速 插值 器 
animLinear.setInterpolator(new LinearInterpolator()); 
anim = animLinear; 

} else if (type ==3) { // 文字 大 小 + 震荡 插值 器 + 浮 点 型 估 值 器 
anim = animBounce; 
/ 给 属性 动画 添加 动画 事件 监听 器 。 目 的 是 在 动画 结束 时 恢复 文字 大 小 
anim.addListener(this); 

} 

if (anim != nul]) { 
anim.setDuration(2000); // 设置 动画 的 播放 时 长 
anim.start(); “// 开始 播放 属性 动画 


b 


// 在 属性 动画 开始 播放 时 触发 
public void onAnimationStart(Animator animation) {} 


// 在 属性 动画 结束 播放 时 触发 
public void onAnimationEnd(Animator animation) { 
让 (animation.equals(animBounce)) { // 震荡 动画 

// 构造 一 个 在 文字 大 小 上 变化 的 属性 动画 
ObjectAnimator anim = ObjectAnimator.ofFloat(tv_interpolator "textSize", 60f, 20f); 
/ 给 属性 动画 设置 震荡 插值 器 
anim.setInterpolator(new BouncelInterpolator()); 
/ 给 属性 动画 设置 浮 点 型 估 值 器 
anim.setEvaluator(new FloatEvaluator()); 
anim.setDuration(2000); / 设置 动画 的 播放 时 长 
anim.start(); “// 开始 播放 属性 动画 


y 


// 在 属性 动画 取消 播放 时 触发 
public void onAnimationCancel(Animator animation) {} 


// 在 属性 动画 重复 播放 时 触发 
public void onAnimationRepeat(Animator animation) {} 


插值 器 和 估 值 器 的 演示 效果 如 图 12-26 和 图 12-27 所 示 。 其 中 , 如 图 12-26 所 示 为 文字 大 小 
变 大 时 的 画面 ， 如 图 12-27 所 示 为 文字 大 小 变 小 时 的 画面 。 此 处 采用 的 是 震荡 插值 器 ， 由 于 截 
图 无 法 准确 反映 震荡 的 动画 效果 ， 因 此 建议 读者 自行 编译 并 运行 测试 代码 ， 这 样 会 有 更 直观 的 


感受 。 
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插值 器 类 型 : 文字 大 小 + 震荡 插值 器 + 浮 点 型 估 ~ 插值 器 类 型 : 文字 大 小 + 震荡 插值 器 + 浮 点 型 估 “ 
看 看 插值 器 的 效果 是 什么 看 看 插值 器 的 效果 是 什么 
图 12-26 震荡 插值 器 开始 播放 图 12-27 震荡 插值 器 即将 结束 


12.4 ”矢量 动画 


本 节 介绍 了 矢量 动画 的 基础 知识 与 实现 过 程 ， 首 先 描述 了 矢量 图 形 的 XML 文件 格式 ， 然 
后 详细 解释 了 可 缩放 矢量 图 形 SVG 标记 的 标准 定义 ， 接 着 阐述 了 如 何 利用 属性 动画 的 手段 来 
实现 矢量 动画 ， 最 后 演示 了 如 何 通过 矢量 技术 仿照 支付 宝 的 支付 成 功 动画 。 


12.4.1 矢量 图 形 


矢量 是 一 种 既 有 大 小 又 有 方向 的 几何 对 象 ， 它 通常 被 标示 为 一 个 带 箭头 的 线段 。 若 干 个 
矢量 拼接 在 一 起 , 便 形成 了 矢量 图 形 。 矢 量 图 不 同 于 一 般 的 图 形 , 它 是 由 一 系列 几何 曲线 构成 
的 图 像 ， 这 些 曲 线 又 以 数学 上 定义 的 坐标 点 连接 而 成 。 

Android 从 5.0 开始 引入 矢量 图 形 VectorDrawable， 最 初 只 能 支持 5.0 及 更 高 版 本 的 系统 ， 
因而 限制 了 手机 上 的 矢量 图 形 应 用 。 好 在 谷歌 公司 亡羊补牢 , 在 最 新 推出 的 Android Studio 3.0 
中 , 已 将 矢量 图 形 兼容 到 4.X 系统 , 无 需 开 发 者 进行 繁琐 的 适 配 工作 。 不 过 为 了 兼容 4.X 版 本 ， 
还 是 要 修改 模块 的 build.gradle， 在 文件 内 部 的 defaultConfig 节点 之 下 添加 下 面 一 行 配置 ， 表 
示 开 启 矢量 图 形 的 支持 库 : 

vectorDrawables useSupportLibrary = true // 矢量 图 形 的 XML 定义 文件 需要 


安 卓 的 矢量 图 形 由 XML 文件 定义 ， 故 而 需要 开发 者 在 drawable 目录 提供 一 个 XML 格式 
的 矢量 图 形 定义 , 然后 系统 根据 矢量 定义 自动 计算 该 图 形 的 绘制 区 域 。 因为 绘图 结果 是 动态 计 
算得 到 ， 所 以 不 管 缩放 到 多 少 比 例 , 矢量 图 形 都 会 一 样 的 清晰 , 不 像 普通 位 图 那样 拉 大 后 会 变 
模糊 。 矢 量 图 形 的 XML 文件 结构 可 分 为 三 个 层次 : 根 标签 、 组 标签 、 路 径 标签 ， 分 别 介绍 如 
Es 


1. 根 标签 vector 
vector 标签 表示 当前 定义 的 是 一 个 完整 的 矢量 图 形 。 该 标签 支持 的 主要 属性 说 明 如 下 。 


e android:name: 指定 矢量 图 形 的 名 称 。 
e@ android:width: 指定 矢量 图 形 的 默认 宽度 ， 一 般 使 用 dp 数值 。 如 果 在 layout 布局 文件 
中 将 ImageView 的 layout_ width 设置 为 wrap_content, 同时 src 设置 为 该 矢量 图 形 , 则 
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ImageView 控件 的 宽度 就 是 此 处 的 android:width。 

。 android:height: 指定 矢量 图 形 的 默认 高 度 ， 一 般 使 用 dp 数值 。 

e android:viewportWidth: 指定 视图 空间 的 宽度 ， 即 虚拟 坐标 系 的 宽度 ,后 续 路 径 的 坐标 
信息 都 位 于 该 视图 空间 之 内 。 

e android:viewportHeight: 指定 视图 空间 的 高 度 ， 即 虚拟 坐标 系 的 高 度 。 

ee android:alpha: 指定 矢量 图 形 的 的 透明 度 ， 取 值 为 0.0 到 1.0。 


这 里 要 注意 width/height 与 viewportWidth/viewportHeight 两 组 宽 高 的 区 别 , 前 者 指 的 是 矢 
量 图 形 被 外 部 世界 观察 到 的 尺寸 大 小 ， 故 而 采用 了 带 dp 单位 的 绝对 数值 ;而 后 者 指 的 是 矢量 
图 形 为 内 部 几何 路 径 所 参照 的 空间 范围 , 故而 采用 了 不 带 单位 的 相对 数值 。 正 因为 矢量 图 形 中 
的 几何 路 径 以 相对 坐标 来 标记 , 所 以 不 管 矢 量 图形 缩 放 到 多 少 比例 , 其 内 部 的 几何 形状 也 会 按 
同样 比例 缩放 。 


2. 组 标签 group 


group 标签 定义 了 一 组 路 径 的 共同 行为 《如 一 起 旋转 、 一 起 缩放 、 一 起 平移 等 ) 。 该 标签 
支持 的 主要 属性 说 明 如 下 。 
android:name: 指定 分 组 对 象 的 名 称 。 
android:pivotX: 指定 旋转 中 心 点 的 横 轴 坐标 。 
android:pivotY: 指定 旋转 中 心 点 的 纵 轴 坐标 。 
android:rotation: 指定 分 组 对 象 的 旋转 角度 。 
android:scaleX: 指定 分 组 对 象 在 横 轴 上 的 缩放 比例 。 取 值 0.5 表示 缩小 一 半 ， 取 值 2.0 
表示 放大 一 倍 。 
android:scaleY: 指定 分 组 对 象 在 纵 轴 上 的 缩放 比例 。 
e android:translateX: 指定 分 组 对 象 在 横 轴 上 的 平移 距离 。 
e android:translateY: 指定 分 组 对 象 在 纵 轴 上 的 平移 距离 。 


3. 路 径 标签 path 


path 标签 定义 了 一 个 路 径 的 几何 描述 ， 既 可 以 表示 一 根 曲线 ， 也 可 以 表示 一 块 平面 区 域 。 
该 标签 支持 的 主要 属性 说 明 如 下 。 


android:name: 指定 几何 路 径 的 名 称 。 

android:pathData: 指定 几何 路 径 的 数据 定义 。 数 据 格式 需 符合 SVG 标准 。 
android:fillColor: 指定 平面 区 域 的 颜色 。 若 不 指定 ， 则 不 绘制 平面 区 域 。 
android:fillAlpha: 指定 平面 区 域 的 透明 度 。 

android:strokeColor: 指定 曲线 的 颜色 。 若 不 指定 ， 则 不 绘制 曲线 颜色 。 
android:strokeWidth: 指定 曲线 的 宽度 。 

android:strokeAlpha: 指定 曲线 的 透明 度 。 

android:strokeLineCap: 指定 曲线 的 首尾 外 观 。 取 值 说 明 有 三 个 : butt (默认 值 ， 直 线 
边缘 ) 、round ( 圆 形 边缘 ) 、square (方形 边缘 ) 。 
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。 android:strokeLineJoin: 指定 两 条 曲线 相交 的 边 角 外 观 。 取 值 说 明 有 三 个 : miter ( 默认 
值 ， 锐角 ) 、round ( 圆 角 ) 、bevel ( 钝 角 ) 。 

e android:trimPathStart: 指定 几何 路 径 从 哪里 开始 绘制 。 取 值 为 0.0 到 1.0， 比 如 取 值 0.4 
表示 只 绘制 后 面 十 分 之 六 的 内 容 ， 前 面 十 分 之 四 不 予 绘制 。 

e android:trimPathEnd: 指定 几何 路 径 到 哪里 结束 绘制 。 取 值 为 0.0 到 1.0， 比 如 取 值 0.4 
表示 只 绘制 前 面 十 分 之 四 的 内 容 ， 后 面 十 分 之 六 不 予 绘制 。 

e android:trimPathOffset: 指定 几何 路 径 的 绘制 偏 移 。 取 值 为 0.0 到 1.0， 表 示 线 条 从 
trimPathOffsetttrimPathStart 处 一 直 绘制 到 trimPathOffsetttrimPathEnd 处 。 


路 径 信 息 有 几 个 地 方 容易 混淆 ， 下 面 补充 说 明 一 下 相关 细节 : 

(1) 关于 直线 边缘 butt 和 方形 边缘 square 的 区 别 ， 乍 看 起 来 直线 边缘 与 方形 边缘 没什么 
差别 ,但 矢量 图 形 的 方形 边缘 其 实 是 套 上 一 个 方形 的 帽子 ,既然 是 套 上 去 ， 就 会 比 没 戴 帽 子 的 
时 候 高 一 点 ， 所 以 使 用 square 的 线条 会 比 使 用 butt 的 线条 要 长 一 点 。 

(2) 关于 锐角 miter 和 钝 角 bevel 的 区 别 ，miter 保留 了 原样 的 尖 角 ， 而 bevel 会 把 尖 角 部 
分 切 掉 一 小 块 ， 看 起 来 就 变 钝 了 。 

(3) trimPathOffset+ttrimPathEnd 相 加 的 和 如 果 超 过 1， 也 会 部 分 画 出 来 ， 绘 制 的 是 从 起 
点 到 “trimPathOffsetttrimPathEnd-1” 所 处 的 位 置 。 


12.4.2 ”可 缩放 矢量 图 形 SVG 标记 





上 一 小 节 说 到 ，path 标签 的 android:pathData 属性 ， 取 值 需 符合 SVG 标准 。SVG 全 称 为 
“Scalable Vector Graphics”， 意 即 可 缩放 的 矢量 图 形 ， 它 是 一 种 图 形 格式 ， 专 门 用 于 描述 矢 
量 图 形 的 定义 。SVG 标记 比较 抽象 ， 下 面 先 举 个 简单 的 例子 ， 有 了 直观 的 概念 更 方便 理解 ， 
如 下 所 示 : 

android:pathData=" 
M 30,50 
L325 


这 个 标记 的 定义 不 难 理解 ， 首 先 “M 30,50” 指 的 是 把 画笔 移动 到 坐标 点 (30,50) 的 位 置 ， 
字母 M 代表 move; 后 面 的 “L7535” 指 的 是 从 当前 位 置 画 一 根 线段 到 坐标 点 (75,35)， 字 母 L 
代表 line。 说 白 了 ， 就 是 在 (30,50) 和 (75,35) 两 点 之 间 画 一 根 线段 。 

看 来 ，SVG 数据 的 每 行 定义 一 个 动作 ， 每 行 的 第 一 个 字符 表示 动作 的 类 型 ， 后 面 的 数字 
表示 动作 经 过 的 坐标 点 。 这 便 是 SVG 标记 的 基本 格式 ， 万 变 不 离 其 宗 ， 掌 握 了 规律 才 会 学 得 
更 好 更 快 。 详 细 的 SVG 标记 定义 说 明 见 表 12-6。 


表 12-6 ”SVG 标记 的 使 用 说 明 





绘图 动作 路 径 规 则 说 明 














移动 画笔 Mx0y0 把 画笔 移动 到 坐标 点 (x0.y0) 
画 线段 [Lxiy! 从 当前 位 置 (x0,y0) 画 一 根 线段 到 坐标 点 (x1y1) 
画 水 平 线段 | Hxl 从 当前 位 置 (x0,y0) 画 一 根 水 平 线 到 坐标 点 (xly0) 
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( 续 表 ) 
绘图 动作 路 径 规 则 说 明 
画 垂直 线段 Vyl 从 当前 位 置 (x0,y0) 画 一 根 垂直 线 到 坐标 点 (x0,y1) 
画 二 次 贝 塞 尔 曲线 | Qxayaxlyl 二 次 贝 塞 尔 曲线 的 起 点 是 当前 位 置 ， 终 点 是 (xlyl)， 曲 


线 中 部 向 控制 点 (xa,ya) 凸 出 





画 三 次 贝 塞 尔 曲线 


C xa ya xb yb xly1 


三 次 贝 塞 尔 曲线 的 起 点 是 当前 位 置 ， 终 点 是 (xly1)， 曲 
线 中 部 有 两 个 控制 点 ， 分 别 向 (xa,ya) 和 (xb,yb) 两 方向 凸 
出 




















画 椭圆 的 圆 弧 Aradius-x radius-y 从 当前 位 置 拉 出 一 段 圆 弧 
x-axis-rotation large-arc-flag 
sweep-flag xl yl 

闭合 路 径 Zz 


另外 补充 介绍 一 下 SVG 标记 的 几 个 要 点 : 








连接 起 点 跟 终 点 ， 即 在 起 点 (x0,y0) 与 终点 之 间 画 一 根 线 
段 


(1) 每 个 命令 都 有 大 小 写 形式 ， 大 写 表 示 后 面 的 参数 是 绝对 坐标 ， 小 写 表 示 相 对 坐标 。 
(2) 参数 之 间 用 空格 或 逗号 隔 开 ， 两 种 分 隔 符 的 效果 是 一 样 的 。 
(3) 画 椭圆 圆 弧 的 时 候 ， 用 到 了 较 多 的 参数 ， 分 别 说 明 如 下 。 


radius-x 和 radius-y: 表示 椭圆 的 横 轴 半径 和 纵 轴 半径 。 

x-axis-rotation: 表示 圆 弧 的 旋转 角度 。 

large-arc-flag: 表示 大 弧 标 志 ， 为 0 时 表示 取 小 弧度 ，1 时 取 大 弧度 。 
sweep-flag: 表示 轨迹 标志 ， 为 0 表示 逆 时 针 方 向 ， 为 1 表示 顺 时 针 方向 。 
xl 和 yl: 表示 圆 绝 经 过 某 点 ， 该 点 的 横 坐 标 为 x1， 纵 坐标 为 y1。 


关于 圆 弧 的 large-arc-flag 和 sweep-flag 两 个 参数 标志 ， 光 看 文字 说 明 其 实 有 些 困惑 , 结合 
图 片 来 看 会 比较 容易 理解 ， 二 者 的 取 值 对 比如 图 12-28 所 示 。 








Arc start Arc start Arc start | 
rc end Arc end rcend | 
large-arc-flag=0 large-arc-flag=0 
sweep-flag=0 sweep-flag=1 
Arc start Arc ‘< | 
rc end cend | 
large-arc-flag=1 large-arc-flag=1 
sweep-flag=0 sweep-flag=1 
12-28 ” 圆 弧 标记 的 两 个 参数 取 值 比较 
下 面 使 用 SVG 标记 定义 一 个 心 形 图 案 ， 先 看 看 该 图 案 的 展示 效果 ， 如 图 12-29 所 示 。 
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心 形 图 案 人 脸 图 案 





图 12-29 心 形 图 案 的 矢量 图 形 


观察 心 形 图 案 发 现 ， 它 由 几 根 曲线 组 成 ， 这 几 条 曲线 即 为 贝 塞 尔 曲线 ， 具 体 的 矢量 图 形 
定义 示例 如 下 : 
<vector xmlns:android="http://schemas.android.com/apk/res/android" 
android:width="256dp" 
android:height="256dp" 
android:viewportHeight="32" 
android:viewportWidth="32"> 
<path 
android:fillColor= "#ffaaaa" 
android:pathData= "M20.5,9.5 
€-1.955,0,-3.83,1.268,-4.5,3 
€-0.67,-1.732,-2.547,-3,-4.5,-3 
C8.957,9.5,7,11.432,7,14 
©0,3.53,3.793,6.257,9,11.5 
€5.207,-5.242,9,-7.97,9,-11.5 
C25,11.432,23.043,9.5,20.5,9.5z" /> 
</vector> 


12.4.3 ”利用 属性 动画 实现 矢量 动画 


费 了 老大 的 劲 搞 清楚 SVG 标记 ， 如 果 仅 仅 画 个 静态 的 矢量 图 形 ， 未 免 大 材 小 用 了 。 其 实 
矢量 图 形 真正 的 意义 在 于 矢量 动画 , 通过 动态 计算 几何 路 径 的 坐标 , 从 而 实现 局 部 或 整体 的 动 
画 效 果 ， 这 才 是 矢量 图 形 的 杀手 铜 呀 。 

Android 提供 了 AnimatedVectorDrawable 这 么 一 个 矢量 动画 类 , 但 开发 者 还 得 通过 属性 动 
画 及 其 XML 标签 方 可 实现 动画 定义 。 先 看 看 AnimatedVectorDrawable 的 以 下 几 个 常用 方法 : 

erIegisterAnimationCallback: 注册 动画 监听 器 ， 需 实现 Animatable2.AnimationCallback 

接口 的 两 个 方法 ， 即 onAnimationStart 和 onAnimationEnd。 
start: 开始 播放 动画 。 
stop: 停止 播放 。 
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ereverse: 倒 过 来 播放 。 

再 看 看 如 何 通过 属性 动画 实现 矢量 动画 效果 .理论 上 , 矢量 图 形 的 三 个 标签 (vector、 group、 
path) 都 拥有 可 以 用 来 播放 动画 的 属性 ; 不 过 实际 开发 的 时 候 ， 常 用 的 只 有 三 类 属性 可 用 作 动 
画 ， 详 述 如 下 。 

1. 变换 类 属性 


该 类 属性 包括 vector 标签 的 android:alpha， 以 及 group 标签 的 android:rotation 、 
android:scaleX、android:scaleY、android:translateX、android:translateY 等 等 ， 这 几 个 属性 分 别 
对 应 于 补 间 动 画 的 灰 度 动画 、 旋 转动 画 、 缩 放 动画 、 平 移动 画 。 

因为 该 类 属性 实现 的 是 大 家 熟悉 的 补 间 动 画 效果 ， 所 以 这 里 就 不 再 做 具体 演示 了 。 

2. 路 径 类 属性 


该 类 属性 主要 指 path 标签 的 android:pathData, 通过 设置 几何 路 径 的 起 始 状态 与 终止 状态 ， 
可 实现 两 个 几何 形状 之 间 的 渐变 效果 ， 如 一 个 圆圈 从 小 变 大 ， 又 如 一 条 曲线 变 成 直线 等 。 

路 径 变 换 的 矢量 动画 效果 如 图 12-30 和 图 12-31 所 示 ， 其 中 图 12-30 展示 的 是 动画 开始 之 
时 的 峰 脸 图 12-31 展示 的 是 动画 结束 之 后 的 笑脸 。 


animation 









简单 笑脸 动画 


简单 笑脸 动画 睐 眼 笑脸 动画 


睐 眼 笑脸 动画 


-dd 


Ar 








图 12-30 ”矢量 动画 开始 之 时 的 与 脸 图 12-31 矢量 动画 结束 之 后 的 笑脸 


从 哄 脸 到 笑脸 ， 对 应 的 是 下 面 的 矢量 图 形 定义 文件 vector_face_eye.xml， 其 中 分 别 定义 了 
脸 部 轮廓 、 左 眼 、 右 眼 、 嘴 巴 共 4 个 器 官 : 


<vector xmlns:android="http://schemas.android.com/apk/res/android" 

android:height="200dp" 

android:width="200dp" 

android:viewportHeight="100" 

android:viewportWidth="100"> 

<!-- 下 面 定 义 了 脸 部 轮廓 的 路 径 信息 --> 

<path 
android:fillColor="(@color/yellow" 
android:pathData="(@string/path_circle" /> 
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<!-- 下 面 定义 了 左 眼 的 路 径 信息 --> 

<path 
android:name="eye_left" 
android:strokeColor="(@android:color/black" 
android:strokeWidth="4" 
android:strokeLineCap="round" 
android:pathData="(@string/path_eye left sad"/> 

<!-- 下 面 定义 了 右 眼 的 路 径 信息 --> 

<path 
android:name="eye_right" 
android:strokeColor="(@android:color/black" 
android:strokeWidth="4" 
android:strokeLineCap="round" 
android:pathData="(@string/path_eye right_sad" /> 

<!-- 下 面 定 义 了 嘴巴 的 路 径 信息 --> 

<path 
android:name="mouth" 
android:strokeColor="(@android:color/black" 
android:strokeWidth="4" 
android:strokeLineCap="round" 
android:pathData="(@string/path_face_mouth sad"/> 

</vector> 


以 及 脸 部 里 面 三 处 器 官 变化 的 属性 动画 定义 文件 , 包括 左 眼 的 属性 动画 定义 、 右 眼 的 属性 
动画 定义 和 嘴巴 的 属性 动画 定义 。 
下 面 是 左 眼 的 属性 动画 定义 文件 anim_smile_eye_left.xml: 


<objectAnimator xmlns:android="http://schemas.android.com/apk/res/android" 
android:duration="3000" 
android:propertyName="pathData" 
android:valueFrom="(@string/path_eye_left_sad" 
android:valueTo="(@string/path_eye_left_happy" 
android:valueType="pathType" 
android:interpolator="(@android:anim/accelerate_interpolator" /> 


下 面 是 右 眼 的 属性 动画 定义 文件 anim_smile_eye_right.xml: 


<objectAnimator xmlns:android="http://schemas.android.com/apk/res/android" 
android:duration="3000" 
android:propertyName="pathData" 
android:valueFrom="(@string/path_eye _right_sad" 
android:valueTo="(@string/path_eye_right_happy" 
android:valueType="pathType" 
android:interpolator="(@android:anim/accelerate_interpolator" /> 
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下 面 是 嘴巴 的 属性 动画 定义 文件 anim_smile_mouth.xml: 


<objectAnimator xmlns:android="http://schemas.android.com/apk/res/android" 
android:duration="3000" 
android:propertyName="pathData" 
android:valueFrom="(@string/path_face_ mouth_sad" 
android:valueTo="(@string/path_face_ mouth happy" 
android:valueType="pathType" 
android:interpolator="(@android:anim/accelerate_interpolator" /> 


最 后 是 笑脸 的 矢量 动画 定义 例子 animated_vector_smile_eye.xml: 


<animated-vector xmiIns:android="http://schemas.android.com/apk/res/android" 
android:drawable="(@drawable/vector face eye"> 
<!-- 指定 嘴巴 的 动画 定义 -> 
<target 
android:name="mouth" 
android:animation="@anim/anim_smile mouth" /> 
<!-- 指定 左 眼 的 动画 定义 -> 
<target 
android:name="eye_left" 
android:animation="(@anim/anim_smile_eye left" /> 
<!-- 指定 右 眼 的 动画 定义 -> 
<target 
android:name="eye_right" 
android:animation="(@anim/anim_smile_eye right" /> 
</animated-vector> 


不 要 忘 了 在 代码 中 进行 矢量 动画 的 播放 操作 : 


// 开始 播放 矢量 动画 

private void startVectorAnim(int drawableId) { 
iv_vector_smile.setImageResource(drawableId); 
/ 将 图 形 转换 为 具备 动画 特征 的 类 型 ， 然 后 再 进行 播放 
((Animatable) iv_vector_smile.getDrawable()).start(); 

} 


3. 修剪 类 属性 

该 类 属性 包括 path 标签 的 android:trimPathStart 和 android:trimPathEnd， 可 实现 矢量 图 形 
逐步 展开 或 者 逐步 消失 的 动画 效果 。 
12.4.4” 仿 支付 宝 的 支付 成 功 动画 


上 一 小 节 末 尾 提 到 修剪 类 属性 也 可 用 来 展示 矢量 动画 ， 即 一 开始 显示 较 少 的 路 径 ， 接 着 
逐步 显示 越 来 越 多 的 路 径 , 直至 最 后 显示 所 有 的 路 径 。 比 如 常见 的 支付 宝 支 付 成 功 动 画 , 便 是 
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通过 修剪 类 属性 来 实现 的 , 完整 的 支付 成 功 动画 包含 两 个 形状 , 首先 在 外 面 画 个 圆圈 ,然后 在 
到 圈 里 面 画 个 打 勾 符号 。 因 为 圆圈 和 打 勾 两 个 图 案 并 不 相连 ,如果 按照 普通 的 处 理 方式 ,就 会 
一 边 画 圆圈 一 边 画 打 勾 ， 这 不 是 我 们 所 期 望 的 画 完 圆圈 后 再 画 打 勾 的 效果 。 所 以 要 想 让 圆圈 动 
画 和 打 勾 动画 按 顺 序 播放 , 得 分 别 定义 圆圈 的 矢量 图 形 和 打 勾 的 矢量 图 形 , 然后 等 圆圈 动画 播 
放 完 毕 ， 再 开始 播放 打 勾 动画 。 

下 面 是 外 侧 圆圈 图 案 的 矢量 图 形 定义 文件 vector_pay_circle.xml: 


<vector xmlns:android="http://schemas.android.com/apk/res/android" 
android:height="100dp" 
android:viewportHeight="100" 
android:viewportWidth="100" 
android:width="100dp" > 
<path 
android:name="circle" 
android:pathData=" 
M 10,50 
A40400101049" 
android:strokeAlpha="1" 
android:strokeColor="(@color/blue_sky" 
android:strokeLineCap="round" 
android:strokeWidth="3" /> 
</vector> 

































































下 面 是 添加 打 勾 图 案 的 完整 矢量 图 形 ( 含 圆圈 图 形 〉 定 义 文件 vector_pay_success.xml: 
<vector xmlns:android="http://schemas.android.com/apk/res/android" 
android:height="100dp" 
android:viewportHeight="100" 
android:viewportWidth="100" 
android:width="100dp" > 
<path 
android:name="circle" 
android:pathData=" 
M 10,50 
A40400101049" 
android:strokeAlpha="1" 
android:strokeColor="(@color/blue_sky" 
android:strokeLineCap="round" 
android:strokeWidth="3" /> 
<path 
android:name="hook" 
android:pathData=" 
M 30,50 
L4565 
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3 
android:strokeAlpha="1" 
android:strokeColor="(@color/blue_sky" 
android:strokeLineCap="butt" 
android:strokeWidth="3" /> 
</vector> 


接着 是 支付 成 功 的 属性 动画 的 XML 定义 文件 anim_pay.xml， 其 中 指定 通过 修剪 类 属性 
trimPathEnd 来 泻 染 动画 : 


<objectAnimator xmlns:android="http://schemas.android.com/apk/res/android" 
android:duration="1000" 
android:interpolator="(@android:interpolator/linear" 
android:propertyName="trimPathEnd" 
android:valueFrom="0" 
android:valueTo="1" 
android:valueType="floatType" /> 


最 后 是 矢量 动画 的 两 个 定义 文件 ， 其 中 一 个 是 如 下 所 示 用 来 播放 圆圈 动画 的 XML 文件 : 


<animated-vector xmins:android="http://schemas.android.com/apk/res/android" 
android:drawable="(@drawable/vector_pay_circle"> 
<!-- 指定 支付 圆圈 的 动画 定义 --> 
<target 


android:name="circle" 





android:animation="(@anim/anim_pay" 亡 
</animated-vector> 


另 一 个 则 是 下 面 用 来 播放 圆圈 动画 后 继 的 打 勾 动画 的 XML 文件 : 


<animated-vector xmlns:android="http://schemas.android.comy/apk/res/android” 
android:drawable="(@drawable/vector_pay_success"> 
<!-- 指定 支付 打 勾 的 动画 定义 -> 
<target 
android:name="hook" 
android:animation="@anim/anim_ pay" 亡 
</animated-vector> 
在 动画 演示 的 时 候 ， 要 等 到 圆圈 动画 播放 完毕 ， 接 着 才 播 放 打 勾 动画 ， 为 此 得 在 代码 中 
加 以 控制 。 具体 地 说 , 是 调用 AnimatedVectorDrawable 对 象 的 registerAnimationCallback 方法 ， 
给 矢量 动画 注册 一 个 事件 监听 器 Animatable2.AnimationCallback， 一 旦 监听 到 前 面 的 动画 播放 
结束 ， 就 开始 播放 后 面 的 动画 。 不 过 需 注意 ,事件 监听 器 Animatable2.AnimationCallback 迟 至 
Android 6.0 才 为 系统 所 支持 , 那么 对 于 6.0 之 前 的 4X 和 5.X 版 本 ,无 法 直接 监控 到 动画 结束 
事件 ， 只 能 手工 设置 一 个 定时 任务 ， 上 个 动画 播放 多 久 ， 该 任务 就 延迟 多 久 ， 然 后 启动 下 个 动 
画 的 播放 操作 。 详 细 的 矢量 动画 接续 代码 片段 如 下 所 示 : 
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public void onClick(View v) { 


上 


if (v.getId() 一 Rid.btn_ vector pay) { 


/ 开始 播放 画 圈 的 矢量 动画 
startVectorAnim(R.drawable.animated_vector pay_circle); 
if (Build.VERSION.SDK_INT >= Build.VERSION CODES.M) { 
// 为 画 圈 动画 注册 一 个 矢量 动画 图 形 的 监听 器 
((AnimatedVectorDrawable) mDrawable) 
-TegisterAnimationCallback(new VectorAnimListener()); 
}else{ 
// 延迟 1 秒 后 启动 打 勾 动画 的 播放 任务 
new Handler().postDelayed(mHookRunnable, 1000); 


/ 开始 播放 矢量 动画 


private void startVectorAnim(int drawableId) { 


ly 


if (Build.VERSION.SDK_INT >= Build.VERSION_ CODES.M) { 


// 从 指定 资源 编号 的 矢量 文件 中 获取 图 形 对 象 
mDrawable = getResources().getDrawable(drawableld); 
// 设置 图 像 视图 的 图 形 对 象 
iv_vector_hook.setImageDrawable(mDrawable); 

// 将 该 图 形 强制 转换 为 动画 图 形 ， 并 开始 播放 
((Animatable) mDrawable).start(); 


} else { 


/ 设置 图 像 视图 的 图 像 资源 编号 
iv_vector_hook.setImageResource(drawableld); 

// 将 图 像 视图 承载 的 图 形 强制 转换 为 动画 图 形 ， 然 后 再 进行 播放 
((Animatable) iv_vector_hook.getDrawable()).start(); 


/ 定义 一 个 动画 图 形 的 监听 器 
// Android 6.0 以 后 系统 采取 监听 器 Animatable2.AnimationCallback 监控 动画 播放 事件 
Private class VectorAnimListener extends Animatable2.AnimationCallback { 


/ 在 动画 图 形 开始 播放 时 触发 
public void onAnimationStart(Drawable drawable) {} 


/ 在 动画 图 形 结束 播放 时 触发 
public void onAnimationEnd(Drawable drawable) { 


/ 开始 播放 打 勾 的 矢量 动画 
startVectorAnim(R.drawable.animated_vector pay_success); 
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/ 定义 一 个 打 勾 动画 的 播放 任务 
/Android 4X 和 5.X 系统 ， 只 能 利用 定时 任务 来 延迟 执行 新 动画 的 播放 
private Runnable mHookRunnable = new Runnable() { 
public void run0) { 
// 开始 播放 打 勾 的 矢量 动画 
startVectorAnim(R.drawable.animated_vector pay_success); 
b 
上 
真 不 容易 , 这 下 支付 成 功 动画 才 算 是 弄 好 了 , 支付 动画 的 效果 如 图 12-32 和 图 12-33 所 示 ， 
其 中 图 12-32 为 正在 播放 圆圈 动画 ， 图 12-33 为 正在 播放 打 勾 动画 。 


ULiiel Tiieil 


播放 矢量 打 勾 动画 播放 矢量 打 勾 动画 





\ (9 


图 12-32 正在 播放 圆圈 动画 图 12-33 ”正在 播放 打 勾 动画 


12.5 动画 的 实现 手段 


本 节 介绍 动画 技术 常见 的 3 种 实现 手段 ， 包 括 以 帧 动画 为 代表 的 延 时 重 绘 方式 、 以 补 间 
动画 和 属性 动画 为 代表 的 设置 状态 参数 方式 以 及 为 解决 拖 电 卡 顿 问题 而 采用 的 滚动 器 。 


12.5.1 使 用 延 时 重 绘 





延 时 重 绘 是 最 基本 的 动画 实现 手段 ， 代 表 技术 为 帧 动画 ， 每 隔 若干 毫秒 就 用 新 图 片 换 掉 
原 图 片 ， 人 眼看 过 去 仿佛 画面 动 起 来 了 。 
当然 ， 除 了 帧 动画 ， 还 有 不 少 地 方 采用 延 时 重 绘 技术 ， 比 如 第 6 章 的 圆 弧 进度 动画 、 第 7 
章 的 Banner 指示 器 等 ， 它 们 都 是 连续 调用 onDraw 或 dispatchDraw 方法 实现 动画 效果 。 尽 管 
这 方面 读者 已 经 比较 熟悉 ， 不 过 为 加 深 对 该 手段 的 理解 ， 不 妨 再 动手 实现 一 个 饼 图 动画 。 
下 面 是 饼 图 动画 的 参考 代码 片段 : 
// 定义 一 个 绘图 刷新 任务 
private Runnable mRefresh = new Runnable() { 
public void run(O) { 
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mDrawingAngle += mIncrease; 

让 (mDrawingAngle <=mEndAngle) { / 未 绘制 完成 
postInvalidate(); / 立即 刷新 视图 
/ 延迟 若干 时 间 后 再 次 启动 绘图 刷新 任务 
mHandler.postDelayed(this, mInterval); 

}else { / 已 绘制 完成 
isRunning = false; 

0 


上 


protected void onDraw(Canvas canvas) { 

super.onDraw(canvas); 

if (isRunning) { 
int width = getMeasured Width(); 
int height = getMeasuredHeight(); 
// 视图 的 宽 高 取 较 小 的 那个 作为 扇形 的 直径 
int diameter = Math.min(width, height); 
/ 创建 扇形 的 矩形 边界 
RectF rectf = new RectF((width - diameter) / 2, (height - diameter) / 2, 

(width + diameter) / 2, (height + diameter) / 2); 

// 在 画布 上 绘制 指定 角度 扇形 。 第 四 个 参数 为 true 表示 绘制 扇形 ， 为 false 表示 绘制 圆 弧 
canvas.drawArc(rectf, 0, mDrawingAngle, true, mPaint); 


} 


饼 图 动画 的 播放 效果 如 图 12-34 和 图 12-35 所 示 。 其 中 ， 如 图 12-34 所 示 为 饼 图 动画 开始 
播放 时 的 画面 ， 如 图 12-35 所 示 为 饼 图 动画 即将 结束 时 的 画面 。 





By 


图 12-34” 饼 图 动画 开始 播放 图 12-35 ” 饼 图 动画 即将 结束 
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12.5.2 ”设置 状态 参数 


设置 状态 参数 是 最 常见 的 动画 实现 手段 ， 代 表 技 术 为 补 间 动 画 
变 视 图 的 状态 属性 数值 让 该 视图 蹦 起 来 、 跳 起 来 。 
虽然 通过 属性 动画 可 实现 大 多 数 状 态 变更 动画 ， 但 是 属性 动画 





和 属性 动画 ， 通 过 持续 改 


要 求 有 明确 的 初始 状态 值 


和 结束 状态 值 ， 如 果 这 些 起 止 状 态 值 无 法 确定 , 中 间 还 要 加 入 其 他 运算 , 属性 动画 就 无 法 胜任 


如 此 复杂 的 要 求 ， 只 能 自己 实现 状态 变更 动画 了 。 
举 个 例子 ， 经 常 看 朋友 圈 动 态 ， 其 动态 内 容 通 常 只 展示 前 面 一 


段 ， 如 果 用 户 想 看 完整 的 


需要 点 击 展开 动态 ， 看 完 后 再 点 击 收缩 动态 。 这 样 整 个 页 面 的 动态 列表 就 会 比较 均衡 ， 不 会 出 
现 个 别 动态 占用 大 片 屏 幕 的 情况 。 查 看 博客 的 文章 列表 也 一 样 , 一 开始 只 展示 文章 开头 的 几 行 





内 容 ， 有 需要 时 再 点 击 显 示 全 篇 文章 。 
点 击 展开 动态 ， 再 点 击 收缩 动态 ， 展 开 与 收缩 动画 其 实 是 不 停 


地 变更 视图 高 度 。 如 果 动 


态 内 容 初始 展示 3 行文 字 , 初始 高 度 就 是 每 行文 字 的 高 度 乘 以 3， 展 开 后 的 高 度 就 是 每 行 高 度 
乘 以 总 行 数 。 有 了 视图 高 度 的 起 始 值 和 终止 值 就 可 以 实现 动画 效果 了 。 


下 面 是 展开 动画 的 参考 代码 片段 : 


public void onClick(View v) { 
if (v.getId() 一 R.id.ll_content) { 
isSelected = !isSelected; 
// 清除 文本 视图 的 动画 
tv_content.clearAnimation(); 
final int deltaValue; 
// 获得 文本 视图 当前 的 高 度 
final int startValue = tv_content.getHeight(); 
if(isSelected) { // 变 成 选中 ， 则 显示 展开 后 的 所 有 文字 


deltaValue = tv_content.getLineHeight() * ty_content.getLineCount() - startValue; 


} else { // 变 成 未 选中 ， 则 显示 收缩 后 的 正常 行 数 


deltaValue = tv_content.getLineHeight() * mNormalLines - 


/ 创建 一 个 文本 展开 /收缩 动画 
Animation animation = new Animation() { 


/ 在 动画 变换 过 程 中 调用 


startValue; 


protected void applyTransformation(float interpolatedTime, Transformation t) { 


// 随 着 时 间 流 逝 ， 重 新 设置 文本 视图 的 行 高 


tvy_content.setHeight((inb (startValue + deltaValue * interpolatedTime)); 


上 
瑟 
// 设置 动画 的 持续 时 间 为 500 毫秒 
animation.setDuration(500); 
// 开始 文本 视图 的 动画 展示 


ty_content.startAnimation(animation); 
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} 
展开 动画 的 播放 效果 如 图 12-36 和 图 12-37 所 示 。 其 中 ， 如 图 12-36 所 示 为 点 击 文本 区 域 
准备 播放 展开 动画 时 的 画面 ， 如 图 12-37 所 示 为 展开 动画 即将 结束 时 的 画面 。 


anlmation ENE 


遇 到 爱 你 的 人 ， 学 会 感恩 。 遇 到 你 爱 的 遇 到 爱 你 的 人 ， 学 会 感恩 。 遇 到 你 爱 的 


人 ， 学 会 付出 ; 遇 到 你 恨 的 人 ， 学 会 原 人 ， 学 会 付出 ; 遇 到 你 恨 的 人 ， 学 会 原 
谅 。 遇 到 恨 你 的 人 ， 学 会 道歉 ; 遇 到 欣赏 你 谅 。 遇 到 恨 你 的 人 ， 学 会 道歉 ; 遇 到 欣赏 你 
的 和 .学会 关 多 地 到 你 帮 和 的 人 ,学会 





图 12-36 ”展开 动画 准备 播放 图 12-37 展开 动画 即将 结束 
12.5.3 ”滚动 器 Scroller 


第 11 章 的 实战 项 目 通 过 移动 手势 拖 忠 图 片 到 指定 位 置 ， 拖 忠 后 直接 在 新 位 置 重 绘 整个 图 
片 , 不 知道 读者 有 没有 发 现 ， 这 种 拖 忠 方式 的 画面 存在 卡 顿 现象 。 因 为 根据 人 眼 的 机 理 ， 每 秒 
连续 播放 20 帧 图 片 才 不 易 感 觉 到 画面 卡 顿 , 而 拖 忠 重 绘 的 做 法 频率 绝对 小 于 每 秒 20 次 , 所 以 
自然 会 出 现 画 面 卡 顿 。 

为 解决 拖 忠 卡 顿 的 问题 ，Android 提供 了 滚动 器 Scroller， 通 过 Scroller 可 以 实现 平滑 滚动 
的 效果 。 下 面 是 Scroller 的 常用 方法 说 明 。 


estartScroll: 设置 开始 滑动 的 参数 ， 包 括 起 始 的 横 纵 坐标 、 横 纵 偏 移 量 和 滑动 的 持续 时 
间 。 
ecomputeScrollOffset: 计算 滑动 偏 移 量 。 返 回 值 可 判断 滑动 是 否 结束 ， 返 回 fasle 表示 
滑动 结束 ， 返 回 true 表示 还 在 滑动 中 。 
getCurrX: 获得 当前 的 横 坐 标 。 
getCurrY: 获得 当前 的 纵 坐 标 。 
getDuration: 获得 滑动 的 持续 时 间 。 
forceFinished: 强行 停止 滑动 。 
isFinished: 判断 滑动 是 否 结束 。 返 回 fasle 表示 还 未 结束 ， 返 回 true 表示 滑动 结束 。 
该 方法 与 computeScrollOffset 的 区 别 在 于 : 
(1) computeScrollOffset 内 部 计算 偏 移 量 ， 而 isFinished 只 返回 标志 不 做 其 他 处 理 。 
(2) computeScrollOffset 返回 fasle 表示 滑动 结束 ， 而 isFinished 返回 true 表示 滑动 结束 。 
虽然 滚动 器 提供 了 滑动 的 相关 计算 函数 ， 但 是 并 不 能 直接 滑动 视图 。 因 为 Scroller 是 一 个 
运算 模拟 器 ， 根 据 时 间 的 流逝 计算 横 纵 坐 标 偏 移 ， 要 想 让 视图 真正 动 起 来 , 还 得 调用 视图 自身 
的 滑动 方法 处 理 滑动 操作 ， 即 调用 scrollTo 和 scrollBy 两 个 方法 。 
escrollTo: 将 视图 滑动 到 指定 坐标 位 置 。 
e@ scrollBy: 将 视图 滑动 指定 偏 移 量 。 查看 源码 会 发 现 scrollBy 方法 内 部 就 是 调用 scrollTo 
方法 ， 当 然 得 先 给 当前 坐标 加 上 偏 移 量 ， 从 而 得 到 滑动 后 的 绝对 坐标 。 
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下 面 是 使 用 滚动 器 的 参考 代码 : 
/ 平滑 滚动 的 文本 视图 


public class ScrollTextView extends TextView { 
private Scroller mScroller; / 声明 一 个 滚动 器 对 象 


public ScrollTextView(Context context, AttributeSet attrs) { 
super(context, attrs); 
/ 创建 一 个 新 的 滚动 器 
mScroller = new Scroller(context); 


// 平滑 滚动 到 指定 的 绝对 坐标 
public void smoothScrollTo(int fx, int fy) { 
int dx = fx - mScroller.getFinalX(); 
int dy= fy - mScroller.getFinalY(); 
smoothScrollBy(dx, dy); / 滚动 相对 偏 移 
1 


/ 从 当前 位 置 平 滑 滚动 到 相对 位 移 

public void smoothScrollBy(int dx, int dy) { 
/ 设置 滚动 偏 移 量 ， 注 意 正 数 是 往 左 滚 往 上 滚 ， 负 数 才 是 往 右 滚 往 下 滚 
mScroller.startScroll(mScroller.getFinalX(), mScroller.getFinalY(), -dx, -dy); 
/ 调用 invalidate 方法 才能 保证 computeScroll 函数 会 被 调用 
invalidate0); / 立即 刷新 视图 


// 在 调用 invalidate 方法 之 后 触发 
@Override 
public void computeScroll() { 
/ 判断 滚动 器 是 否 已 经 滚动 完成 
让 (mScrollercomputeScrollOffsetO) { 
// 滚动 到 指定 位 置 。 调 用 View 的 scrollTo 方法 才能 完成 实际 的 滚动 
scrollTo(mScroller.getCurrX(), mScroller.getCurrY()); 
postInvalidate0); / 刷新 视图 


} 
super.computeScroll0; 


} 

滚动 器 的 演示 效果 如 图 12-38 和 图 12-39 所 示 。 其 中 ， 如 图 12-38 所 示 为 视图 滚动 开始 前 
的 画面 ， 如 图 12-39 所 示 为 视图 滚动 结束 后 的 画面 。 单 看 截图 不 方便 观察 动画 效果 ， 建 议 读者 
自己 运行 代码 查看 效果 图 。 
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您 拖 动 我 啦 
您 拖 动 我 啦 
图 12-38 ”视图 尚未 开始 滚动 图 12-39 视图 滚动 已 经 结束 


12.6 “实战 项 目 : 仿 QQ 空间 的 动感 影集 


动画 可 以 做 得 千变万化 、 很 酷 很 炫 ， 故 而 常用 于 展示 具有 纪念 意义 的 组 图 ， 比 如 婚纱 照 、 
亲子 照 、 艺 术 照 等 。 这 方面 做 得 比较 好 、 使 用 比较 广泛 的 当 数 QQ 空间 的 动感 影集 ， 用 户 添加 
-组 图 片 , 动感 影集 便 给 每 张 图 片 演 染 不 同 的 动画 效果 ,让 原本 静止 的 图 片 变 得 活泼 起 来 ， 辅 
以 各 种 精致 的 动画 特效 ， 营造 一 种 赏心悦目 的 感觉 。 本 节 以 “ 仿 QQ 空间 的 动感 影集 ”为 实战 
项 目 ， 结 合 本 章 的 动画 技术 实现 开发 者 自己 的 动感 影集 。 


12.6.1 设计 思 


动感 影集 的 目的 是 使 用 动画 技术 呈现 前 后 图 片 的 
动态 切换 效果 ， 用 到 的 动画 必须 承上启下 ， 而 且 要 求 
具备 一 定 的 视觉 美感 。 以 这 样 的 标准 来 衡量 ， 目 前 适 
用 于 动感 影集 的 动画 种 类 不 算 多 , 下 面 都 拿 来 练 练 手 。 
动感 影集 的 播放 效果 如 图 12-40 所 示 ， 很 明显 这 是 一 
个 包含 旋转 动画 在 内 的 集合 动画 。 

当然 ， 实 战 项 目的 动感 影集 不 仅 采 用 集合 动画 ， 
还 包括 其 他 种 类 动画 ， 读 者 不 妨 先 列举 一 部 分 ， 看 看 
有 哪些 能 够 应 用 在 动感 影集 中 。 下 面 是 笔者 罗列 的 部 
分 影集 动画 技术 。 图 1240 动感 影集 中 的 集合 动画 效果 

(1) 淡 入 淡出 动画 : 用 于 前 后 两 张 图 片 的 渐变 切换 。 

(2) 灰 度 动画 : 用 于 从 无 到 有 渐变 显示 一 张 图 片 。 


站 人 全 族 师 全 0 








(3) 平移 动画 : 用 于 把 上 层 图 片 抽 离 当前 视图 。 
(4) 缩放 动画 : 用 于 逐步 缩小 并 隐没 上 层 图 片 。 
(5) 旋转 动画 : 用 于 将 上 层 图 片 思 离 当前 视图 。 
(6) 裁剪 动画 : 用 于 把 上 层 图 片 逐 步 裁剪 完 。 


(7) 其 余 动 画 : 更 多 动画 特效 切换 ， 包 括 百 叶 窗 动画 、 马 赛 克 动画 等 。 
动画 技术 用 起 来 不 难 ， 关 键 要 用 好 ， 只 有 用 到 位 才能 让 你 的 App 烟 烟 生 辉 、 锦 上 添 花 。 
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12.6.2 ”小 知识 : 画布 的 绘图 层次 


本 书 到 目前 为 止 ， 画布 Canvas 上 的 绘图 操作 都 是 在 同一 个 图 层 上 进行 的 。 这 就 意味 着 如 
果 存 在 重合 区 域 , 后 面 绘制 的 图 形 就 必然 覆盖 前 面 的 图 形 。 但 绘图 是 比较 复杂 的 事情 , 不 是 直 
接 覆 盖 这 么 简单 ， 有 些 特 殊 的 绘图 操作 往往 需要 做 与 、 或 、 非 运算 , 如 此 才能 实现 百 变 的 图 像 
Android 给 画布 的 图 层 显示 制定 了 许多 规则 ， 详 细 的 图 层 显 示 规 则 见 表 12-7。 表 中 的 上 层 
指 的 是 后 面 绘制 的 图 形 Src， 下 层 指 的 是 前 面 绘制 的 图 形 Dst。 
表 12-7 ”图 层 模式 的 取 值 说 明 









































PorterDuff.Mode 类 的 图 层 模式 说 明 
CLEAR 不 显示 任何 图 形 
SRC 只 显示 上 层 图 形 
DST 只 显示 下 层 图 形 
SRC_OVER 按 通 常情 况 显 示 ， 即 重 县 部 分 由 上 层 遮 盖 下 层 
DST_OVER 重合 部 分 由 下 层 遮 盖 上 层 ， 其 余部 分 正常 显示 
SRC_IN 只 显示 重合 部 分 的 上 层 图 形 
DST_IN 只 显示 重 县 部 分 的 下 层 图 形 
SRC_OUT 只 显示 上 层 图 形 的 未 重合 部 分 
DST_OUT 只 显示 下 层 图 形 的 未 重合 部 分 
SRC_ATOP 只 显示 上 层 图 形 区 域 ， 但 重合 部 分 显示 下 层 图 形 
DST_ATOP 只 显示 下 层 图 形 区 域 ， 但 重合 部 分 显示 上 层 图 形 
XOR 不 显示 重合 部 分 ， 其 余部 分 正常 显示 
DARKEN 重合 部 分 按 颜 料 混合 方式 加 深 ， 其 余部 分 正常 显示 
LIGHTEN 重合 部 分 按 光 照 重 合 方式 加 亮 ， 其 余部 分 正常 显示 
MULTIPLY 只 显示 重合 部 分 ， 且 重生 部 分 的 颜色 混合 加 深 
SCREEN 过 滤 重 又 部 分 的 深 色 ， 其 余部 分 正常 显示 

这 些 图 层 规则 的 文字 说 明 有 点 令 人 费解 , 还 是 看 画面 效 Oia A 





果 比 较 直观 。 如 图 12-41 所 示 , 圆圈 是 先 绘制 的 图 形 ， 正 方 图 加 

形 是 后 绘制 的 图 形 ， 图 例 展 示 了 运用 不 同 规则 时 的 显示 画 

面 。 合理 运用 图 层 规则 可 以 实现 酷 炫 的 动画 效果 ,比如 百叶 ”| 人 | el 

窗 动画 、 马 赛区 动画 等 。 D> | | | 涝 
要 想 在 画布 中 使 用 图 层 规则 ， 就 要 调用 画布 对 象 的 












































三 DstOut SrcATop DstATop Xor 
setXfermode 方法 ， 并 指定 相应 的 图 层 模 式 。 下 面 是 百叶 窗 | 
视图 的 代码 ， 其 中 采用 了 DST_IN 模式 : I IS | 
public class ShutterView extends View { Duken: ~ Lighioe Mp. Ban 
private Paint mPaint; // 声明 一 个 画笔 对 象 
J 


private int mOriention = LinearLayout.HORIZONTAL; // 百 
叶 窗 的 方向 12-41 各 种 图 层 规则 的 画面 效果 
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private int mLeafCount = 10; / 叶片 的 数量 

private PorterDu 任 Mode mMode = PorterDu 作 Mode.DST_ IN; / 绘图 模式 为 只 展示 交集 
private Bitmap mBitmap; / 声明 一 个 位 图 对 象 

private int mRatio = 0; // 绘制 的 比率 


public ShutterView(Context context) { 
this(context, null); 


public ShutterView(Context context, AttributeSet attrs) { 
super(context, attrs); 
mPaint = new Paint(); / 创建 一 个 新 的 画笔 


1/ 设置 百叶 窗 的 方向 
public void setOriention(int oriention) { 
mOriention = oriention; 


// 设置 百叶 窗 的 叶片 数量 
public void setLeafCount(int leaf count) { 
mLeafCount = leaf_count; 


// 设置 绘图 模式 
public void setMode(PorterDuff.Mode mode) { 
mMode = mode; 


/ 设置 位 图 对 象 
public void setImageBitmap(Bitmap bitmap) { 
mBitmap = bitmap; 


} 
/ 设置 绘图 比率 
public void setRatio(int ratio) { 
mRatio = ratio; 
invalidate0; / 立即 刷新 视图 
! 
@Override 


protected void onDraw(Canvas canvas) { 
super.onDraw(canvas); 
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if (mBitmap — null) { 
return; 
b; 
int width = getMeasuredWidth(); 
int height = getMeasuredHeight(); 
/ 清空 画布 
canvas.drawColor(Color.TRANSPARENT); 
/ 创建 一 个 庶 罩 位 图 
Bitmap mask = Bitmap.createBitmap(width, height, mBitmap.getConfig()); 
// 创建 一 个 遮 日 画布 
Canvas canvasMask = new Canvas(mask); 
for (inti= 0;i< mLeafCount; i++) { 
if(mOriention 一 LinearLayout.HORIZONTAL) { V 水 平方 向 
int column_ width = (int) Math.ceil(width * 1f/ mLeafCount); 
int left = column width * i; 
int right = left + column width * mRatio / 100; 
/ 在 遮 单 画布 上 绘制 各 矩形 叶片 
canvasMask.drawRect(left, 0, right, height, mPaint); 
} else { // 垂直 方向 
int row_height = (int) Math.ceil(height * 1f/ mLeafCount); 
int top = row_height * i; 
int bottom = top + row_height * mRatio / 100; 
// 在 庶 罩 画布 上 绘制 各 矩形 叶片 
canvasMask.drawRect(0, top, width, bottom, mPaint); 
} 
} 
/ 设置 离 屏 缓存 
int saveLayer = canvas.saveLayer(0, 0, width, height, null, Canvas.ALL_SAVE FLAG); 
Rect src = new Rect(0, 0, mBitmap.getWidth(), mBitmap.getHeightO); 
Rect dst = new Rect(0, 0, width, width * mBitmap.getHeight() / mBitmap.getWidth()); 
/ 绘制 目标 图 像 
canvas.drawBitmap(mBitmap, src, dst, mPaint); 
/ 设置 混合 模式 (只 在 源 图 像 和 目标 图 像 相 交 的 地 方 绘制 目标 图 像 》 
mPaint.setXfermode(new PorterDuffXfermode(mMode)); 
/ 再 绘制 源 图 像 的 遮 四 
canvas.drawBitmap(mask, 0, 0, mPaint); 
/ 还 原 混合 模式 
mPaint.setXfermode(null); 
/ 还 原画 布 


canvas.restoreToCount(saveLayer); 
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百叶 窗 视图 ShutterView 仅仅 是 一 个 静态 画面 ， 若 想 让 它 动 起 来 形成 百叶 窗 动 画 还 得 利用 
属性 动画 渐进 设置 ratio 属性 ， 使 整个 百叶 窗 的 各 个 叶片 逐步 合 上 ， 从 而 实现 动画 特效 。 下 面 
是 百叶 窗 动画 的 代码 : 
public class ShutterActivity extends AppCompatActivity { 
private ShutterView sv_shutter; / 声明 一 个 百叶 窗 视图 对 象 





@Override 
protected void onCreate(Bundle savedInstanceState) { 


b 


super.onCreate(savedInstanceState); 

setContentView(R.layout.activity_shutter); 

// 从 布局 文件 中 获取 名 叫 sv_shutter 的 百叶 窗 视图 

sv_shutter = findViewById(R.id.sv_shutter); 

/ 设置 百叶 窗 视图 的 位 图 对 象 
sv_shutter.setImageBitmap(BitmapFactory.decodeResource(getResources(), R.drawable.bdg03)); 
initShutterSpinner(); 


// 初始 化 动画 类 型 下 拉 框 
private void initShutterSpinner() { 


) 


ArrayAdapter<String> shutterAdapter = new ArrayAdapter<String>(this, 
R.layout.item _select, shutterArray); 

Spinner sp_shutter = fndViewById(R.id.sp_shutter); 

sp_shutter.setPrompt(" 请 选择 百叶 窗 动 画 类 型 "); 

sp_shutter.setAdapter(shutterAdapter); 

sp_shutter.setOnltemSelectedListener(new ShutterSelectedListener()); 

sp_shutter.setSelection(0); 


private String[] shutterArray = 如水 平 五 叶 ", "水 平 十 叶 ", "水 平 二 十 叶 "， 


"垂直 五 叶 " " 秋 直 十 叶 ", " 重 直 二 十 时" 


class ShutterSelectedListener implements OnltemSelectedListener { 


public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
/ 设置 百叶 窗 的 方向 
sv_shutter.setOriention((arg2 <3) ? LinearLayouLHORIZONTAL : LinearLayout.VERTICALD); 
if(arg2 = 0 arg2 =—=3) { 
sv_shutter.setLeafCount(5); / 设置 百叶 窗 的 叶片 数量 
} else 计 (arg2 —1|are2—4){ 
syv_shuttersetLeafCount(10); / 设置 百叶 窗 的 叶片 数量 
} else 计 (arg2 —2|are2==—5) { 
sy_shuttersetLeafCount(20); / 设置 百叶 窗 的 叶片 数量 
} 
// 构造 一 个 按 比率 逐步 展开 的 属性 动画 
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ObjectAnimator anim = ObjectAnimator.ofInt(sv_shutter, "ratio", 0, 100); 
anim.setDuration(3000); / 设置 动画 的 播放 时 长 
anim.start(); / 开始 播放 属性 动画 

} 


public void onNothingSelected(AdapterView<?> arg0) {} 


} 


百叶 窗 动画 的 播放 效果 如 图 12-42 和 图 12-43 所 示 。 其 中 ， 如 图 12-42 所 示 为 百叶 窗 动画 
开始 播放 时 的 画面 ， 如 图 12-43 所 示 为 百叶 窗 动画 即将 结束 播放 时 的 画面 。 


百叶 窗 动画 样式 : 水 平 五 叶 百叶 窗 动画 样式 : 水 平 五 叶 


jul 
有 











图 12-42 ”百叶 窗 动 画 开始 播放 图 12-43 ”百叶 窗 动画 即将 结束 播放 
马赛 克 动 画 的 实现 原理 与 百叶 窗 动 画 类 似 ， 只 是 在 绘制 图 片 训 单 时 选择 了 不 同 的 算法 ， 
其 余 步骤 与 百叶 窗 动画 是 一 样 的 。 马 赛 克 视图 的 相关 代码 参见 本 书 附 带 源码 animation 模块 的 
MosaicView.java 和 MosaicActivity.java， 马 赛 克 动 画 的 播放 效果 如 图 12-44 和 图 12-45 所 示 。 
其 中 ， 如 图 12-44 所 示 为 马赛 克 动 画 开 始 播放 时 的 画面 ， 如 图 12-45 所 示 为 马赛 克 动 画 即 将 结 
柬 播放 时 的 画面 。 





马赛 克 动 画 样式 : 


马赛 克 动 画 样式 : 水 平 三 十 格 





水 平 三 十 格 


























图 12-44 ”马赛克 动画 开始 播放 图 12-45 马赛 克 动 画 即 将 结束 
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12.6.3 ”代码 示例 


(1) 如 果 把 动画 描述 定义 在 XML 文件 中 ， 注 意 动画 定义 文件 要 放 在 res/anim 目录 下 。 
(2) 测试 手机 的 Android 版 本 要 求 不 低 于 Android 4.3， 因 为 裁剪 动画 用 到 的 矩形 估 值 器 
RectEvaluator 是 在 Android 4.3 之 后 引入 的 。 


动感 影集 的 测试 挺 简单 的 ， 无 须 什 么 操作 流程 ， 只 要 沉静 欣赏 屏幕 上 的 动画 轮 播 即 可 。 
动感 影集 的 轮 播 效 果 如 图 12-46 一 图 12-51 所 示 。 其 中 ， 图 12-46 展示 了 灰 度 动画 ， 图 12-47 
展示 了 裁剪 动画 ， 图 12-48 展示 了 百叶 窗 动画 ， 图 12-49 展示 了 马赛 克 动 画 ， 图 12-50 展示 了 
淡 入 淡出 动画 ， 图 12-51 展示 了 平移 动画 。 





正在 播放 灰 度 动画 正在 播放 裁剪 动画 











12-46 动感 影集 的 灰 度 动画 效果 图 12-47 动感 影集 的 裁剪 动画 效果 


时 正在 播放 百叶 窗 动画 | 正在 播放 马赛 克 动画 _ 


a 











12-48 动感 影集 的 百叶 窗 动画 效果 图 1249 动感 影集 的 马赛 克 动画 效果 
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animation 


正在 播放 平移 动画 








图 12-50 动感 影集 的 淡 入 淡出 动画 效果 图 12-51 动感 影集 的 平移 动画 效果 
为 方便 演示 ， 动 感 影集 未 做 成 可 选择 图 片 文件 的 形式 ， 而 是 在 代码 中 国定 了 几 张 演示 图 
片 。 另 外 ， 各 种 动画 的 执行 顺序 也 是 固定 的 ， 没 有 做 成 可 定制 动画 顺序 。 读 者 若 有 兴趣 ， 可 在 
源码 的 基础 上 进行 改造 ， 使 其 更 贴近 真实 动感 影集 的 使 用 习惯 。 
动感 影集 的 示例 源码 内 容 较 长 ， 限 于 篇 幅 就 不 在 书 上 贴 了 ， 读 者 可 参考 本 书 附 带 源码 
animation 模块 的 YingjiActivity.java。 


12.7 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 常见 动画 技术 ， 包 括 帧 动画 的 用 法 〈 帧 动画 、GIF 动画 、 
淡 入 淡出 动画 )》、 补 间 动 画 的 用 法 〈 补 间 动 画 的 种 类 与 用 法 、 集 合 动画 、 在 飞 掠 横幅 中 使 用 补 
间 动 画 ) 、 属 性 动画 的 用 法 〈 属 性 动画 、 属 性 动画 组 合 、 插 值 器 和 估 值 器 ) 、 矢 量 动画 的 用 法 
(矢量 图 形 、SVG 标记 、 实 现 矢量 动画 、 仿 支付 宝 的 支付 成 功 动画 ) 、 常 见 的 动画 实现 手段 
〈 使 用 延 时 重 绘 、 设 置 状 态 参数 、 滚 动 器 Scroller) 。 最 后 设计 了 一 个 实战 项 目 “ 仿 QQ 空间 
的 动感 影集 ”， 在 该 项 目的 App 编码 中 采用 本 章 介绍 的 主要 动画 技术 ， 实 现 了 图 片 动态 轮换 
的 效果 。 另 外 ， 介 绍 了 画布 的 绘图 层次 ， 以 及 如 何 实现 百叶 窗 动 画 和 马赛 克 动 画 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 5 种 开发 技能 : 

(1) 学 会 如 何 使 用 帧 动画 实现 动态 效果 。 

(2) 学 会 在 合适 的 场合 使 用 补 问 动画 。 

(3) 学 会 属性 动画 的 基本 用 法 和 高 级 用 法 。 

(4) 学 会 矢量 动画 的 基础 原理 及 其 具体 运用 。 

(5) 学 会 常用 的 几 种 动画 实现 手段 。 














本 章 介绍 App 开发 常见 的 多 媒体 技术 , 主要 包括 如 何 使 用 各 种 图 像 控 件 实现 自 定义 相册 、 
如 何 使 用 几 种 主要 的 音频 播放 技术 、 如 何 使 用 几 种 常见 的 视频 播放 控件 、 如 何在 屏幕 上 划分 多 
窗口 进行 特殊 处 理 。 最 后 结合 本 章 所 学 的 知识 分 别 演示 了 两 个 实战 项 目 “ 影 视 播 放 器 一 一 爱 看 
剧场 ”和 “音乐 播放 器 一 一 浪花 音乐 ”的 设计 与 实现 。 





13.1 相 上 册 


本 节 介 绍 自 定义 相册 的 实现 过 程 ， 首 先 说 明 使 用 画廊 或 循环 视图 如 何 实现 简单 的 相册 ， 
接着 曾 述 使 用 图 像 切 换 器 如 何 实现 相册 的 左右 滑动 功能 ,然后 分 别 介绍 卡片 视图 与 调 色 板 的 用 
法 ， 并 结合 上 述 图 像 控件 完成 一 个 图 片 查看 器 一 一 青青 相册 。 


13.1.1 画廊 Gallery 


前 几 章 使 用 文件 对 话 框 打开 图 片 时 只 能 看 到 图 片 的 文件 名 ， 看 不 到 图 片 的 缩 略图 ， 对 用 
户 来 说 很 不 方便 , 因为 光 看 文件 名 怎么 知道 这 张 图 片 什么 模样 呢 ? 如 果 是 在 电脑 上 , 就 可 以 查 
看 一 组 图 片 的 缩 略图 列表 , 很 容易 找到 想 要 的 图 片 。 在 手机 上 可 以 使 用 相应 的 图 像 控件 做 出 缩 
略图 展示 的 相册 效果 。 

画廊 Gallery 是 专门 用 于 展示 图 片 列表 的 控件 ， 左 右 滑动 手势 即 可 展示 内 翌 的 图 片 列表 ， 
画面 效果 类 似 于 一 个 平面 万 花 简 。 尽管 Android 将 Gallery 标记 为 Deprecation (表示 已 废弃 ) ， 
建议 开发 者 采用 HorizontalScrollView 或 ViewPager 代替 , 不 过 Gallery 用 来 轮 播 图 片 是 一 个 挺 
好 的 选择 。 不 妨 了 解 一 下 Gallery 控件 ， 并 结合 其 他 控件 加 深 对 图 像 开发 的 理解 。 

下 面 是 Gallery 的 常用 方法 说 明 。 
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setSpacing: 设置 图 片 之 问 的 间隔 大 小 ， 对 应 的 XML 属性 是 spacing。 
setUnselectedAlpha: 设置 未 选 定 图 片 的 透明 度 ， 对 应 的 XML 属性 是 unselectedAlpha。 
取 值 范围 为 0.0~ 1.0，0.0 表示 完全 透明 ，1.0 表示 完全 不 透明 。 

setAdapter: 设置 画廊 的 适配器 。 

getSelectedItemId: 获取 当前 选中 的 视图 序号 。 

setSelection: 设置 当前 选中 第 几 个 视图 。 

setOnItemClickListener: 设置 单项 的 点 击 监听 器 。 


使 用 画廊 看 起 来 很 简单 , 接 下 来 试 着 用 Gallery 结合 ImageView 实现 观看 画廊 的 相册 效果 。 
首先 在 布局 文件 中 放置 一 个 框架 布局 FrameLayout， 里 面 放 一 个 画廊 控件 与 一 个 图 像 视图 控 
件 ，ImageView 设置 为 充满 整个 屏幕 ，Gallery 放 在 屏幕 下 方 ， 然后 监听 Gallery 控件 的 单项 点 
击 事件 ， 当 用 户 点 击 指定 图 片 项 时 ， 使 用 ImageView 控件 填充 该 图 片 ， 也 就 是 点 小 图 看 大 图 。 

下 面 是 通过 Gallery 与 ImageView 实现 简单 相册 的 代码 : 


public class GalleryActivity extends AppCompatActivity implements OnItemClickListener { 





private ImageView iv_gallery; // 声明 一 个 用 于 展示 大 图 的 图 像 视图 
private Gallery gL_sgallery; / 声明 一 个 画廊 视图 对 象 
// 画廊 需要 的 图 片 资源 编号 数组 
private int[] mImageRes= { 
R.drawable.scenel, R.drawable.scene2, R.drawable.scene3, 
R.drawable.scene4, R.drawable.scene5, R.drawable.scene6}; 


(@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_gallery); 
/ 从 布局 文件 中 获取 名 叫 iv_gallery 的 图 像 视图 
iv_gallery = findViewByld(R.id.iv_gallery); 
/ 给 图 像 视图 设置 图 片 的 资源 编号 
iv_gallery.setImageResource(mImageRes[0]); 
initGallery0; / 初始 化 画廊 视图 

b 


// 初始 化 画廊 视图 
private void initGallery() { 
int dip_pad = Utils.dip2px(this, 20); 
// 从 布局 文件 中 获取 名 叫 gl_gallery 的 画廊 视图 
glL_gallery = fmdViewById(R.id.gl_gallery); 
// 设置 画廊 的 上 下 间距 
gl_gallery.setPadding(0, dip_pad, 0, dip_pad); 
/ 设置 画廊 视图 各 单项 之 间 的 空白 距离 
gl_gallery.setSpacing(dip_pad); 
/ 设置 画廊 视图 未 选中 部 分 的 透明 度 
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glL_gallery.setUnselectedAlpha(0.5D; 
/ 给 画廊 视图 设置 画廊 适配器 
gl _ gallery.setAdapter(new GalleryAdapter(this, mImageRes)); 
/ 给 画廊 视图 设置 单项 点 击 监听 器 
gl_gallery.setOnItemClickListener(this); 
b 
@Override 
public void onItemClick(AdapterView<?> parent, View view, int position, long id) { 


/ 在 图 像 视图 上 面 展示 大 图 
iv_gallery.setImageResource(mImageRes[position]); 


} 
Gallery 相册 的 画面 效果 如 图 13-1 和 图 13-2 所 示 。 其 中 ， 如 图 13-1 所 示 为 展示 相册 第 一 
张 图 片 时 的 画面 ， 如 图 13-2 所 示 为 点 击 第 二 张 小 图 时 ， 屏 幕 展 示 第 二 张大 图 的 画面 。 





图 13-1 画廊 展示 第 一 张 图 片 图 13-2 画廊 展示 第 二 张 图 片 


如 果 想 用 其 他 控件 替代 Gallery， 就 可 以 考虑 使 用 功能 强大 的 循环 视图 RecyclerView。 具 
体 实现 时 主要 是 定义 一 个 水 平方 向 的 线性 布局 管理 器 ， 然 后 通过 适配器 填 入 图 片 列表 。 
使 用 RecyclerView 与 ImageView 实现 相册 的 代码 很 简单 ， 举 例如 下 : 
public class RecyclerViewActivity extends AppCompatActivity implements OnItemClickListener { 
private ImageView iv_photo; / 声明 一 个 用 于 展示 大 图 的 图 像 视图 
private RecyclerView rv_photo; / 声明 一 个 循环 视图 对 象 
// 画廊 需 要 的 图 片 资源 编号 数组 
private int[] mImageRes={ 
R.drawable.scenel, R.drawable.scene2, R.drawable.scene3, 
R.drawable.scene4, R.drawable.scene5, R.drawable.scene6}; 





@Override 
protected void onCreate(Bundle savedInstanceState) { 
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setContentView(R.layout.activity_recycler_view); 
// 从 布局 文件 中 获取 名 叫 iv_gallery 的 图 像 视图 


iv_photo = findViewById(R.id.iv_photo); 

/ 给 图 像 视图 设置 图 片 的 资源 编号 

iv_photo.setImageResource(mImageRes[0]); 

initRecyclerView0; / 初始 化 循环 视图 
b 


// 初始 化 循环 视图 
private void initRecyclerView() { 


/ 从 布局 文件 中 获取 名 叫 rv_photo 的 循环 视图 


TV_photo = findViewById(R.id.rv_photo); 
/ 创建 一 个 水 平方 向 的 线性 布局 管理 器 


LinearLayoutManager manager = new LinearLayoutManager(this, LinearLayout.HORIZONTAL., 


false); 
/ 设置 循环 视图 的 布局 管理 器 
TV_photo.setLayoutManager(manager); 
/ 构建 一 个 相片 列表 的 线性 适配器 


PhotoAdapter adapter = new PhotoA dapter(this, mImageRes); 


/ 设置 线性 列表 的 点 击 监听 器 
adapter.setOnItemClickListener(this); 
/ 给 rv_photo 设置 相片 线性 适配器 
TV_photo.setAdapter(adapter); 

/ 设置 rv_photo 的 默认 动画 效果 


TV_photo.setItemAnimatornew DefaultItemAnimator()); 


/ 给 rv_photo 添加 列表 项 之 间 的 空白 装饰 


Tv_photo.addItemDecoration(new SpacesItemDecoration(20)); 


@Override 

public void onltemClick(View view, int position) { 
iv_photo.setImageResource(mImageRes[position 
/ 让 循环 视图 滚动 到 指定 位 置 


TV_photo.scrollToPosition(position); 


]); 


使 用 RecyclerView 方式 实现 的 相册 效果 如 图 13-3 和 图 13-4 所 示 。 其 中 ， 如 图 13-3 所 示 为 





展示 相册 第 3 张 图 片 时 的 画面 ; 如 图 13-4 所 示 为 点 
面 。 


6 第 4 张 小 图 时 ， 屏 幕 展示 第 4 张大 图 的 画 
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13-3 ”循环 视图 展示 第 3 张 图 片 图 13-4 循环 视图 展示 第 4 张 图 片 
13.1.2 图像 切 换 器 ImageSwitcher 


读者 可 能 已 经 发 现 ， 前 面 Gallery 相册 在 切换 大 图 时 比较 生硬 ， 前 后 两 张 图 片 内 一 下 就 切 
过 去 了 , 用 户 体验 不 够 友好 。 有 没有 办 法 让 图 片 切换 自然 一 些 呢 ， 比 如 通过 渐变 动画 的 方式 ? 
答案 肯定 是 有 的 ,就 是 把 占据 整个 屏幕 的 图 像 视图 ImageView 换 成 图 像 切 换 器 ImageSwitcher， 
然后 通过 ImageSwitcher 实现 前 后 图 片 的 切换 动画 。 

ImageSwitcher 继承 自视 图 动画 器 ViewAnimator， 用 于 承载 前 后 两 个 图 像 的 变换 动画 ;与 
之 对 应 的 是 ， 文 本 切换 器 TextSwitcher 承载 前 后 两 个 文本 的 变换 动画 ; 第 11 章 介 绍 的 飞 掠 视 
图 ViewFlipper 是 从 ViewAnimator 派生 而 来 ， 读 者 已 经 知道 它 用 来 承载 前 后 两 个 视图 的 变换 
动画 。 

下 面 介绍 ImageSwitcher 的 常用 方法 。 

e@ setFactory: 设置 一 个 视图 工厂 ,该 视图 工厂 由 ViewFactory 派生 而 来 , 需 重 写 makeView 

方法 返回 工厂 的 具体 视图 。 对 于 ImageSwitcher 来 说 ， 工 厂 返回 的 是 ImageView 对 象 。 
esetImageResource: 设置 当前 图 像 的 资源 ID。 该 方法 与 下 面 的 setImageDrawable 方法 
和 setImageURI 方 法 为 三 选 一 操作 ， 调 用 了 其 中 一 个 方法 ， 就 无 须 调 用 另外 两 个 方法 。 
setImageDrawable: 设置 当前 图 像 的 Drawable 对 象 。 
setImageURI: 设置 当前 图 像 的 URI 地 址 。 
setInAnimation: 设置 后 一 个 图 像 的 进入 动画 。 
setOutAnimation: 设置 前 一 个 图 像 的 退出 动画 。 


这 里 运用 的 动画 技术 跟 第 11 章 和 第 12 章 的 飞 掠 视图 类 似 。 首 先 ， 对 前 后 图 片 的 切换 动 
画 可 以 事先 设置 好 集合 动画 ， 通 过 setInAnimation 和 setOutAnimation 方法 完成 动画 调用 ; 其 
次 ， 前 后 图 片 的 切换 操作 不 但 可 由 Gallery 控件 的 点 击 操作 出 发 ， 而 且 可 由 手势 的 左 滑 和 右 滑 
操作 触发 ， 这 要 借助 于 手势 检测 器 GestureDetector， 通 过 检测 左 滑 手势 和 右 滑 手 势 自 动 轮 播 
图 片 。 

按照 以 上 的 设计 思路 使 用 ImageSwitcher 实现 相册 切换 动画 的 代码 片段 如 下 : 
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/ 初始 化 图 像 切 换 器 
private void initImageSwitcher() { 


' 


public void onIltemClick(AdapterView<?> parent, View view, int position, long id) { 


1 


/ 从 布局 文件 中 获取 名 叫 is_switcher 的 图 像 切 换 器 
is_switcher = findViewById(R.idis_switcher); 

/ 设置 图 像 切 换 器 的 视图 工厂 
is_switcher.setFactory(new ViewFactoryImp!()); 

/ 给 图 像 切换 器 设置 图 片 的 资源 编号 
is_switchersetImageResource(mImageRes[0]); 

// 创建 一 个 手势 监听 器 

GestureTask gestureListener = new GestureTask(); 

/ 创建 一 个 手势 检测 器 

mGesture = new GestureDetector(this, gestureListener); 
/ 设置 手势 监听 器 的 手势 回调 对 象 
gestureListener.setGestureCallback(this); 

/ 给 图 像 切换 器 设置 触摸 监听 器 
is_switcher.setOnTouchListener(this); 


/ 给 图 像 切换 器 设置 淡 入 动画 


is_switcher.setInAnimation(AnimationUtils.loadAnimation(this, R.anim. 包 de_in)); 


/ 给 图 像 切 换 器 设置 淡出 动画 


is_switcher.setOutAnimation(AnimationUtils.loadAnimation(this, R.anim.fade_out)); 


/ 给 图 像 切 换 器 设置 图 片 的 资源 编号 


is_switcher.setImageResource(mImageRes[position]); 


/ 定义 一 个 视图 工厂 
public class ViewFactoryImpl implements ViewFactory { 


b 


/ 在 补足 视图 时 触发 。 图 像 切 换 器 允许 动态 添加 新 视图 ， 就 要 通过 视图 工厂 生成 新 视图 


public View make View() { 
// 创建 一 个 新 的 图 像 视图 
ImageView iv = new ImageView(ImageSwitcherActivity.this); 
iv.setBackgroundColor(Color. WHITE); 
iv.setScaleType(ScaleType.FIT_XY); 
iv.setLayoutParams(new ImageSwitcher.LayoutParams( 


LayoutParams.MATCH PARENT, LayoutParams.MATCH PARENT)); 


return iv; 


/ 在 发 生 触 摸 事件 时 触发 
public boolean onTouch(View v, MotionEvent event) { 
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/ 由 手势 检测 器 接管 触摸 事件 
mGesture.onTouchEvent(event); 
Teturn true; 

1 


/ 在 切换 到 下 一 页 时 触发 
public void gotoNextO { 
/ 给 图 像 切 换 器 设置 向 左 淡 入 动画 
is_switcher.setInAnimation( AnimationUtils.loadAnimation(this, R.anim.push_ left_in)); 
/ 给 图 像 切 换 器 设置 向 左 淡出 动画 
is_switcher.setOutAnimation(AnimationUtils.loadAnimation(this, R.anim.push_left_out)); 
/ 计算 画廊 视图 段 的 下 一 项 编号 
int next pos = (int) (gl_switcher.getSelectedItemId() + 1); 
让 (next pos>= mImageRes.length) { 
next_pos = 0; 
b 
/ 给 图 像 切 换 器 设置 图 片 的 资源 编号 
is_switcher.setImageResource(mImageRes[next_pos]); 
/ 设置 画廊 视图 的 选中 项 
gl_switcher.setSelection(next_pos); 
1 


/ 在 切换 到 上 一 页 时 触发 
public void gotoPre() { 
/ 给 图 像 切 换 器 设置 向 右 淡 入 动画 
is_switcher.setInAnimation(AnimationUtils.loadAnimation(this, R.anim.push_right_in)); 
/ 给 图 像 切 换 器 设置 向 右 淡出 动画 
is_switcher.setOutAnimation(AnimationUtils.loadAnimation(this, R.anim.push_right_out)); 
/ 计算 画廊 视图 的 上 一 项 编号 
int pre_pos = (int) (gl_switcher.getSelectedItemId() - 1); 
if (pre pos <0){ 
pre_pos = mImageRes.length - 1; 
} 
/ 给 图 像 切 换 器 设置 图 片 的 资源 编号 
is_switcher setImageResource(mImageRes[pre_pos]); 
/ 设置 画廊 视图 的 选中 项 
gl_switcher.setSelection(pre_pos); 
} 


相册 切换 动画 的 效果 如 图 13-5 和 图 13-6 所 示 。 其 中 ， 如 图 13-5 所 示 为 切换 开始 的 画面 ， 
此 时 右边 图 片 缓 缓 移 入 屏幕 : 如 图 13-6 所 示 为 切换 即将 结束 的 画面 ， 此 时 右边 图 片 已 经 大 部 
分 移入 屏幕 ， 左 边 图 片 快要 移出 屏幕 了 。 
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13-5 图 像 切换 刚刚 开始 的 画面 图 13-6 图 像 切换 即将 结束 的 画面 


13.1.3 ”图片 查看 器 一 一 青青 相册 


经 过 Gallery 和 ImageSwitcher 的 配合 ， 这 个 相册 有 点 像 模 像样 了 。 当 然 ， 作 为 孜孜 不 倦 、 
勤奋 好 学 的 开发 者 , 绝 不 能 满足 于 一 点 雕 虫 小 技 。 接 下 来 我 们 再 加 上 一 些 技 术 , 让 相册 变 得 更 
加 赏心悦目 。 

首先 加 入 的 技术 是 卡片 视图 CardView, 该 视图 是 Android 在 5.0 后 引入 的 新 控件 。 顾 名 思 
义 ，CardView 拥有 一 个 卡片 式 的 圆 角 边框 ， 边 框 外 缘 有 一 圈 阴 影 ， 边 框 内 缘 有 一 圈 空 白 。 准 
确 地 说 ，CardView 实际 上 是 一 个 布局 视图 ， 继 承 自 Framelayout， 可 以 当 作 具有 边框 效果 的 特 
殊 布局 。 

因为 CardView 是 5.0 之 后 的 新 增 控件 ， 所 以 为 了 兼容 以 前 的 Android 版 本 ， 在 使 用 该 控 
件 前 要 先 修改 build.gradle， 即 在 dependencies 节点 中 加 入 下 面 一 行 代 码 表示 导入 cardview 库 : 

implementation 'com.android.support:cardview-v7:28.0.0" 

CardView 的 常用 属性 与 方法 的 说 明 见 表 13-1。 


表 13-1 ”CardView 的 常用 属性 与 方法 说 明 











CardView 的 属性 名 称 CardView 的 设置 方法 说 明 

cardBackgroundColor setCardBackgroundColor 设置 卡片 边框 的 背景 颜色 
cardComerRadius setRadius 设置 卡片 边框 的 圆 角 半径 
cardElevation setCardElevation 设置 卡片 边缘 的 阴影 高 程 ， 即 宽度 
contentPadding setContentPadding 设置 卡片 边框 的 间隔 





使 用 CardView 属性 时 需要 注意 以 下 两 点 : 


(1) 因为 cardview 库 是 作为 外 部 库 导 入 的 ， 所 以 节点 属性 要 像 对 待 自 定义 控件 一 样 ， 即 
先 在 根 节点 定义 一 个 命名 空间 app 指向 res-auto， 然 后 使 用 “app: 属 性 名 称 ” 的 形式 定义 属性 
值 ， 不 可 直接 使 用 “android: 属 性 名 称 ”。 

(2) 在 设置 阴影 宽度 的 同时 设置 对 应 宽度 的 margin， 因 为 阴影 宽度 不 计 入 卡片 的 宽 高 ， 
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如 果 卡 片 宽 高 设置 为 wrap_content， 阴 影 部 分 就 会 被 自动 截 掉 。 
下 面 是 使 用 CardView 的 代码 : 


public class CardViewActivity extends AppCompatActivity { 
private CardView cv_card; / 声明 一 个 卡片 视图 对 和 象 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_card_view); 
// 从 布局 文件 中 获取 名 叫 cv_card 的 卡片 视图 
cv_card= findViewById(R.id.cv_card); 
initCardSpinner(); / 初始 化 卡片 类 型 下 拉 框 
} 


// 初始 化 卡片 类 型 下 拉 框 

private void initCardSpinnerO { 
ArrayAdapter<String> cardAdapter = new ArrayAdapter<String>(this, 

R.layout.item select, cardArray); 

Spinner sp_card = findViewById(R.id.sp_card); 
sp_card.setPrompt(" 请 选择 卡片 视图 类 型 "); 
sp_card.setAdapter(cardAdapter); 
sp_card.setOnltemSelectedListener(new CardSelectedListener()); 
sp_card.setSelection(0); 


private String[] cardArray = {" 圆 角 与 阴影 均 为 3", " 圆 角 与 阴影 均 为 6"," 圆 角 与 阴影 均 为 10"， 
" 圆 角 与 阴影 均 为 15", " 圆 角 与 阴影 均 为 20", " 圆 角 与 阴影 均 为 30", " 圆 角 与 阴影 均 为 50"}; 
private int[] radiusArray = {3, 6, 10, 15, 20, 30, 50}; 
class CardSelectedListener implements OnltemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
int interval = radiusArray[arg2]; 
// 设置 卡片 视图 的 圆 角 半径 
cv_card.setRadius(interval); 
1/ 设置 卡片 视图 的 阴影 长 度 
cv_card.setCardElevation(interval); 
MarginLayoutParams params = (MarginLayoutParams) cv_card.getLayoutParams(); 
params.setMargins(interval, interval, interval, interval); 
// 设置 卡片 视图 的 布局 参数 
cv_card.setLayoutParams(params); 
上 


public void onNothingSelected(AdapterView<?> arg0) {} 


594 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


} 
卡片 视图 的 显示 效果 如 图 13-7 和 图 13-8 所 示 。 其 中 ， 如 图 13-7 所 示 为 阴影 宽度 为 6 的 
画面 ， 此 时 卡片 看 起 来 比较 薄 ; 如 图 13-8 所 示 为 阴影 宽度 为 15 的 画面 ， 此 时 卡片 看 起 来 比较 


卡片 视图 样式 : ” 圆 角 与 阴影 均 为 6。 ~ 卡片 视图 样式 : ” 圆 角 与 阴影 均 为 15 ~ 


中 -多 





13-7 阴影 厚度 为 6 的 卡片 视图 图 13-8 阴影 厚度 为 15 的 卡片 视图 


介绍 完 卡 片 视图 ， 再 说 明 Android 5.0 引入 的 另 一 个 新 控件 一 一 调 色 板 Palette。 调 色 板 把 
多 种 颜色 混合 在 一 起 ， 调 和 均匀 后 显示 出 新 颜色 。 在 App 使 用 场景 中 常常 会 用 到 背景 色调 ， 
即 根据 前 景 图 片 的 总 体 色 彩 设置 与 之 接近 的 背景 色调 ,这 样 显得 整个 画面 风格 比较 统一 。 例 如 ， 
对 于 喜庆 的 节日 相片 可 设置 偏 红 色调 的 背景 , 对 于 泛 黄 的 老 照 片 可 设置 偏 黄 色调 的 背景 , 对 于 
山水 风景 的 图 片 可 设置 偏 绿色 调 的 背景 。 根 据 每 幅 图 片 的 色彩 情况 自动 计算 该 图 片 的 总 体 色 
调 ， 通 过 调 色 板 控件 Palette 就 能 完成 。 

因为 Palette 是 5.0 之 后 增加 的 新 控件 , 所 以 要 修改 build.gradle, 在 dependencies 节点 中 加 
入 下 面 一 行 代码 表示 导入 palette 库 : 

implementation 'com.android.support:palette-v7:28.0.0° 
下 面 是 Palette 的 常用 方法 说 明 。 


e。 from: 从 位 图 对 象 中 获得 调 色 板 的 构建 对 象 。 

ee Builder.generate: 给 构建 对 象 注册 调 色 板 的 调 色 监听 器 ,因为 Android 认为 计算 色调 是 
耗 时 操作 ， 得 另外 开 线 程 处 理 ， 所 以 要 注册 监听 器 实现 回调 操作 。 调 色 监 听 器 需 实 现 
接口 PaletteAsyncListener 的 onGenerated 方法 ， 该 方法 在 色调 计算 完毕 后 触发 。 

e@ getVibrantSwatch: 获取 偏 亮色 调 的 色 板 对 象 。 调 用 色 板 对 象 的 getRgb 方法 可 得 到 具 
体 颜色 。 

e@ ”getSwatches: 获取 所 有 色 板 对 象 。 因 为 getVibrantSwatch 方法 有 时 会 返回 null， 此 时 
要 调用 getSwatches 方法 取 第 一 条 颜色 。 


调 色 板 的 具体 应 用 可 跟 卡 片 视图 联合 使 用 ， 也 就 是 把 调 色 板 计算 得 到 的 色调 填 入 卡片 视 
图 的 边框 背景 中 ， 从 而 实现 卡片 原 图 与 边框 的 色彩 呼应 效果 。 
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使 用 调 色 板 的 代码 片段 如 下 : 


// 初始 化 调 色 板 
private void initPalette() { 
for (inti= 0; i< mImageRes.length; i++) { 
// 从 资源 图 片 中 获取 图 形 对 象 
Drawable drawable = getResources().getDrawable(mImageRes[i]); 
/ 把 图 形 对 象 转换 为 位 图 对 象 
Bitmap bitmap = ((BitmapDrawable) drawable).getBitmap(); 
/ 从 位 图 对 象 中 生成 调 色 板 的 构建 器 
Palette.Builder builder = Palette.from(bitmap); 


/ 进行 调和 色彩 的 工作 。 因 为 调 色 在 分 线程 中 运行 ， 所 以 其 结果 要 通过 监听 器 异步 获取 


builder.generate(new MyPaletteListener(i)); 


b 


// 定义 一 个 调 色 事件 监听 器 
private class MyPaletteListener implements PaletteAsyncListener { 
private int mPos; // 进行 调 色 处 理 的 图 片 序号 
public MyPaletteListener(int pos) { 
mPos = pos; 
} 


/ 在 调 色 完毕 时 触发 
public void onGenerated(Palette palette) { 
// 获取 偏 亮 色调 的 色 板 对 象 
Palette.Swatch swatch = palette.getVibrantSwatch(); 
if (swatch != null) { 
// 通过 色 板 对 象 获 得 具体 颜色 
mBackColors[mPos] = swatch.getRgb(); 


} else { // getVibrantSwatch 有 时 会 返回 null， 此 时 从 getSwatches 取 第 一 条 颜色 


/ 获取 所 有 色 板 对 象 
List<Palette.Swatch> swatches = palette.getSwatches(); 
/ 取 第 一 个 色 板 的 调和 颜色 
for (Palette.Swatch item : Swatches) { 
mBackColors[mPos] = item.getRgb(); 
break: 
上 
} 
// 给 画廊 视图 设置 调 好 色 的 相册 适配器 


gl album.setAdapter(new AlbumAdapter(PaletteActivity.this, mImageRes, mBackColors)); 
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学 会 了 卡片 视图 与 调 色 板 的 用 法 ， 剩 下 的 工作 便 是 精确 加 工 相册 的 每 张 缩 略 图 ， 给 它们 
加 上 卡片 边框 ， 并 给 边框 背景 设置 该 缩 略 图 的 调和 色 。 赶 紧 动 手 进行 实践 ， 体 验 一 下 自己 的 劳 
动 成 果 带 来 的 喜悦 吧 ! 

装饰 后 的 相册 效果 如 图 13-9 和 图 13-10 所 示 。 其 中 ， 如 图 13-9 所 示 为 打开 第 一 张 图 片 时 
的 相册 画面 ， 如 图 13-10 所 示 为 打开 最 后 一 张 图 片 的 相册 画面 。 





13-9 青青 相册 查看 第 一 张 图 片 图 13-10 青青 相册 查看 最 后 一 张 图 片 


至 此 ， 一 个 初 具 面貌 的 相册 基本 完工 了 。 叫 好 的 App 还 得 有 个 好 听 的 名 称 ， 笔 者 姑且 将 
它 命 名 为 “青青 相册 ”， 读 者 看 看 要 不 要 加 上 什么 新 功能 ， 再 取 一 个 更 好 听 的 名 字 ? 


13.2 ”音频 播放 


本 节 介 绍 了 音频 播放 的 几 种 方式 ， 首 先 说 明了 铃声 工具 的 适用 场合 与 简单 用 法 ， 接 着 阅 
述 了 声音 池 的 运用 场景 ， 它 的 优 缺点 ， 以 及 基本 用 法 ， 然 后 说 明了 音 轨 的 产生 背景 ， 以 及 如 何 
进行 音 轨 的 录制 和 播放 。 


13.2.1 铃声 Ringtone 


在 第 9 章 的 时 候 ， 提 到 媒体 播放 器 MediaPlayer 既 可 用 来 播放 视频 ， 也 可 用 来 播放 音频 。 
可 在 具体 的 使 用 场合 ，MediaPlayer 不 可 避免 地 存在 某 些 播音 方面 的 不 足 之 处 ， 主 要 包括 : 


(1) MediaPlayer 的 初始 化 比较 消耗 资源 ， 尤 其 是 播放 短小 铃 音 时 反应 偏 慢 。 
(2) 一 个 MediaPlayer 同时 只 能 播放 一 个 媒体 文件 ， 无 法 同时 播放 多 个 声音 。 
(3) MediaPlayer 只 能 播放 已 经 完成 编码 的 音频 文件 ， 无 法 直接 播放 原始 音频 ， 也 不 能 流 
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式 播 放 〈 即 边 录 边 播 ) 。 


以 上 问题 各 有 不 同 的 解决 方案 ， 对 第 一 个 问题 来 说 ，Android 提供 了 铃声 工具 Ringtone 处 
理 铃 音 的 播放 。 而 铃声 对 象 则 是 通过 铃声 管理 器 RingtoneManager 的 getRingtone 方法 来 获取 ， 
具体 而 言 ， 铃 声 管理 器 允许 获得 三 种 来 源 的 铃声 ， 说 明 如 下 : 


(1) 系统 自 带 的 铃 音 ， 其 Uri 的 获取 方式 举例 如 下 : 
RingtoneManagergetDefaultUri(RingtoneManagerTYPE RINGTONE); / 来 电 铃 音 
铃声 管理 器 支持 的 系统 铃 音 类 型 取 值 说 明 见 表 13-2。 
表 13-2 铃 音 类 型 的 取 值 说 明 


RingtoneManager 类 的 铃 音 类 型 说 明 





TYPE RINGTONE 来 电 铃声 
TYPE NOTIFICATION 通知 铃声 
TYPE_ALARM 闹钟 铃声 





(2) 内 部 存储 与 SD 卡 上 的 铃 音 文件 ， 其 Uri 的 获取 方式 举例 如 下 : 
Uri.parse("file:///system/media/audio/ui/camera_click.ogg"); // 相机 快门 声 

(3) App 工程 中 res/raw 目录 下 的 铃 音 文件 ， 其 Uri 的 获取 方式 举例 如 下 : 
Uri.parse("android.resource://"+getPackageName()+"/"+R.raw.ring); / 从 资源 文件 中 获取 铃 音 


通过 铃声 管理 器 获得 铃声 对 象 之 后 ， 才 能 进行 铃声 的 播放 操作 。 下 面 是 Ringtone 的 常用 
方法 说 明 : 


。 play: 开始 播放 铃声 。 
estop: 停止 播放 铃声 。 
e isPlaying: 判断 铃声 是 否 正 在 播放 。 


使 用 Ringtone 的 代码 例子 如 下 所 示 : 


public class RingtoneActivity extends AppCompatActivity { 
private TextView tv_volume; 
private Ringtone mRingtone; // 声明 一 个 铃声 对 象 
private int RING_TYPE =AudioManager.STREAM_RING; / 音频 流 的 铃声 类 型 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_ringtone); 
tv_volume = findViewById(R.id.tv_volume); 
initVolumeInfo0; / 初始 化 音量 信息 
initRingSpinner(); 
/ 生成 本 App 自 带 的 铃 音 文件 res/raw/ring.ogg 的 Uri 实例 
uriArray[uriArray.length-1] = Uri.parse("android.resource://" + getPackageName(O+"/"+R raw.ring); 
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// 初始 化 音量 信息 
private void initVolumelInfoO) { 
/ 从 系统 服务 中 获取 音频 管理 器 
AudioManager audio = (AudioManager) getSystemService(Context.AUDIO_SERVICE); 
/ 获取 铃声 的 最 大 音量 
int max Volume = audio.getStream MaxVolume(RING_TYPE); 
/ 获取 铃声 的 当前 音量 
int now Volume = audio.getStream Volume(RING_ TYPE); 
String desc = String.format(" 当 前 铃声 音量 为 %d， 最 大 音量 为 %d， 请 先 将 铃声 音量 调 至 最 大 ", 
nowVolume, max Volume); 
tv_volume.setText(desc); 


// 初始 化 铃声 下 拉 框 

private void initRingSpinnerO { 
ArrayAdapter<String> ringAdapter = new ArrayA dapter<String>(this, 

R.layout.item select, ringArray); 

Spinner sp_ring = findViewBylId(R.id.sp_ring); 
sp_ring.setPrompt(" 请 选择 要 播放 的 铃 音 "); 
sp_ring.setAdapter(ringAdapter); 
sp_ring.setOnItemSelectedListener(new RingSelectedListener()); 
sp_ring.setSelection(0); 


4 


private String[] ringArray = {" 来 电 铃 音 ", "通知 铃 音 ", "闹钟 铃 音 ", 
"相机 快门 声 ", "视频 录制 声 ", "门铃 叮 响声 "}; 

private Uri[] uriArray = { 
RingtoneManager.getDefaultUri(RingtoneManager.TYPE_RINGTONE)，// 来 电 铃 音 
RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION)，// 通知 铃 音 
RingtoneManager.getDefaultUri(RingtoneManager.TYPE_ALARM)，// 闹钟 铃 音 
Uri.parse("file:///system/media/audio/ui/camera_click.ogg")，// 相机 快门 声 
Uri.parse("file:///system/media/audio/ui/VideoRecord.ogg")，// 视频 录制 声 
null }; 


class RingSelectedListener implements OnItemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
// 从 铃 音 文件 的 Uri 中 获取 铃声 对 象 
mRingtone = RingtoneManagergetRingtone(RingtoneActivity.this, uriArray[arg2]); 
/ 开始 播放 铃声 
mRingtone.play(); 
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public void onNothingSelected(AdapterView<?> arg0) {} 


protected void onStopO { 
super.onStop(); 
/ 停止 播放 铃声 
mRingtone.stop(); 


} 
播放 铃 音 只 有 声音 ， 没 有 画面 ， 并 且 Ringtone 也 没 提供 任何 监听 器 ， 所 以 没什么 可 截图 
的 ， 读 者 可 自己 运行 测试 工程 ， 聆 听 具 体 的 铃声 效果 。 


13.2.2 ”声音 池 SoundPool 


对 于 MediaPlayer 无 法 同时 播放 多 个 声音 的 问题 ，Android 提供 了 声音 池 工具 SoundPool， 
使 用 声音 池 即 可 对 多 个 声音 的 播放 进行 调度 。 
使 用 SoundPool 可 以 事先 加 载 多 个 音频 ， 在 需要 时 再 播放 指定 音频 ， 这 样 有 几 个 好 处 : 
(1) 资源 占用 量 小 ， 不 像 MediaPlayer 那么 耗资 源 。 
(2) 相对 MediaPlayer 来 说 ， 延 迟 时 间 非 常 小 。 
(3) 可 以 同时 播放 多 个 音频 ， 从 而 实现 游戏 过 程 中 多 个 声音 县 加 的 情景 。 


当然 ，SoundPool 带 来 方便 的 同时 也 做 了 一 部 分 牺牲 ， 下 面 是 它 的 一 些 使 用 限制 ; 


(1) SoundPool 最 大 只 能 申请 1MB 的 内 存 ， 这 意味 着 它 只 能 播放 一 些 很 短 的 声音 片段 ， 
不 能 用 于 播放 歌曲 或 者 游戏 背景 音乐 。 

(2) 虽然 SoundPool 提供 了 pause 和 stop 方法 ， 但 是 轻易 不 要 使 用 这 两 个 方法 ， 因 为 它 
们 可 能 会 让 App 异常 或 崩溃 。 

(3) SoundPool 建议 播放 ogg 格式 的 音频 ， 据 说 它 对 Wav 格式 的 支持 不 太 好 。 

(4) 待 播放 的 音频 要 提前 加 载 进 声音 池 ， 不 要 等 到 要 播放 的 时 候 才 加 载 ， 和 否则 可 能 播放 
没 声音 。 因为 SoundPool 不 会 等 音频 加 载 完了 才 播 放 , 而 MediaPlayer 会 等 待 加 载 完 毕 才 播放 。 


下 面 是 SoundPool 的 常用 方法 说 明 。 


e 构造 函数 : 可 设置 最 大 音频 个 数 、 音 频 类 型 、 音 频 质量 。 其 中 音频 类 型 一 般 是 
AudioManager.STREAM_MUSIC， 音 频 质量 取 值 为 0 到 100。 

e。 load: 加 载 指定 的 音频 文件 。 返 回 值 为 该 音频 的 编号 。 

。 unload: 印 载 指定 编号 的 音频 。 

eplay: 播放 指定 编号 的 音频 。 可 同时 设置 左右 声 道 的 音量 ( 取 值 为 0.0 到 1.0) 、 优 先 
级 (0 为 最 低 ) 、 是 否 循环 播放 ( 0 为 只 播放 一 次 ，-1 为 无 限 循环 ) 、 播 放 速 率 ( 取 
值 为 0.5-2.0， 其 中 1.0 为 正常 速率 ) 。 

esetVolume: 设置 指定 编号 音频 的 音量 大 小 。 
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setPriority: 设置 指定 编号 音频 的 优先 级 。 

setLoop: 设置 指定 编号 的 音频 是 否 循环 播放 。 

setRate: 设置 指定 编号 音频 的 播放 速率 。 

pause: 暂停 播放 指定 编号 的 音频 。 

resume: 恢复 播放 指定 编号 的 音频 。 

autoPause: 暂停 所 有 正在 播放 的 音频 。 

autoResume: 恢复 播放 所 有 被 暂停 的 音频 。 

stop: 停止 播放 指定 编号 的 音频 。 

release: 释放 所 有 音频 资源 。 

setOnLoadCompleteListener : 设置 音频 加 载 完毕 的 监听 器 。 需 实现 接口 
OnLoadCompleteListener 的 onLoadComplete 方法 ， 该 方法 在 音频 加 载 结束 后 触发 。 


下 面 是 使 用 SoundPool 播放 音频 的 示例 代码 : 


public class SoundPoolActivity extends AppCompatActivity implements OnClickListener { 


private TextView tv_volume; 

private SoundPool mSoundPool;，// 初始 化 一 个 声音 池 对 象 

private HashMap<Integer Integer> mSoundMap; / 声音 编号 映射 

private int SOUND_TYPE = AudioManagerSTREAM_MUSIC; / 音频 流 的 音乐 类 型 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_sound_poo!l); 
tv_volume = findViewById(R.id.tv_volume); 
findViewById(R.id.btn_play_all).setOnClickListener(this); 
findViewById(R.id.btn_play_first).setOnClickListener(this); 
findViewById(R.id.btn_play_second).setOnClickListener(this); 
findViewById(R.id.btn_play_third).setOnClickListener(this); 
initVolumeInfo0; / 初始 化 音量 信息 
initSound(0); / 初始 化 声音 池 

b 


// 初始 化 音量 信息 
private void initVolumeImnfo0 { 
/ 从 系统 服务 中 获取 音频 管理 器 
AudioManager audio = (AudioManager) getSystemService(Context.AUDIO_SERVICE); 
/ 获取 音乐 的 最 大 音量 
int max Volume = audio.getStreamMaxVolume(SOUND _TYPE); 
/ 获取 音乐 的 当前 音量 
intnowVolume = audio.getStreamVolume(SOUND TYPE); 
String desc = String.format(" 当 前 音乐 音量 为 %d， 最 大 音量 为 %d， 请 先 将 铃声 音量 调 至 最 大 ", 
nowVolume, max Volume); 
tv_volume.setText(desc); 
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// 初始 化 声音 池 

private void initSoundO { 
mSoundMap = new Hash Map<Integer, Integer>(); 
/ 初始 化 声音 池 ， 最 多 容纳 三 个 声音 
mSoundPool = new SoundPool(3, SOUND_TYPE, 100); 
loadSound(1, R.raw.beep1); / 加 载 第 一 个 声音 
loadSound(2, R.raw.beep2); / 加 载 第 二 个 声音 
loadSound(3, R.raw.ring); / 加 载 第 三 个 声音 

上 


/ 把 音频 资源 添加 进 声音 池 

private void loadSound(int seq, int resid) { 
/ 把 声音 文件 加 入 到 声音 池 中 ， 同 时 返回 该 声音 文件 的 编号 
int soundID = mSoundPool.load(this, resid, 1); 
mSoundMap.put(seq, soundID); 

b; 


/ 播放 指定 序号 的 声音 
private void playSound(int seq) { 
int soundID = mSoundMap.get(seq); 
/ 播放 声音 池 中 指定 编号 的 声音 文件 
mSoundPool.play(soundID, 1.0f 1.0f, 1, 0, 1.0); 
b 


public void onClick(View v) { 
让 (v.getId() 一 Rid.btn_play_all) { // 同 时 播放 三 个 声音 
playSound(1); 
playSound(2); 
playSound(3); 
} else if (v.getId0) 一 R.id.btn_play_first) { / 播放 第 一 个 声音 
playSound(1); 
} else if (v.getId() 一 R.id.btn_play_second) { // 播放 第 二 个 声音 
playSound(2); 
} else if (v.getId() 一 R.id.btn_play_third) { // 播放 第 三 个 声音 
playSound(3); 
b 
| 


protected void onDestroy() { 
if (mSoundPool {= nulD) { 
mSoundPool.release(); // 释放 声音 池 资 源 
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super.onDestroy(); 


} 
13.2.3 ” 音 轨 录 播 AudioTrack 


话说 Android 摘出 这 么 多 种 播音 方式 ， 搞 得 开发 者 脑袋 都 大 ， 烦 不 烦 呀 。 其 实 这 还 是 跟 不 
同 的 需求 和 用 途 有 关 ， 辟 如 说 语音 通话 功能 要 求实 时 传输 , 手机 这 边 说 一 句 话 , 那 边 就 同步 听 
到 一 句 话 。 如 果 是 MediaRecorder 与 MediaPlayer 组 合 ， 只 能 整 句 话 都 录 完 编码 好 了 ， 才 能 传 
给 对 方 去 播放 ， 这 个 实效 性 就 太 差 了 。 于 是 适用 于 实时 音频 处 理 的 音频 录制 器 AudioRecord 
与 音 轨 播放 器 AudioTrack 组 合 就 应 运 而 生 ， 该 组 合 的 音频 格式 为 原始 的 二 进 制 音频 数据 ， 没 
有 文件 头 和 文件 尾 ， 故 而 可 以 实现 边 录 边 播 的 实时 语音 对 话 。 

MediaRecorder 录制 的 音频 格式 有 amr、aac 等 , MediaPlayer 支持 播放 的 音频 格式 除了 amr、 
aac 之 外 ， 还 支持 常见 的 mp3、wav、mid、ogg 等 经 过 压缩 编码 的 音频 。 而 AudioRecord 录制 
的 音频 格式 只 有 pcm，AudioTrack 可 直接 播放 的 格式 也 只 有 pcm。pcm 格式 有 个 缺点 ， 就 是 在 
播放 过 程 中 不 能 暂停 ， 因 为 音频 数据 是 二 进 制 流 ， 无 法 直接 寻 址 ; 但 pcm 格式 有 个 好 处 一 一 
允许 跨 平台 播放 ， 比 如 iOS 不 能 播放 amr 音频 ， 但 能 播放 pcm 音频 ， 所 以 如 果 Android 手机 
录制 的 语音 需要 传 给 iOS 手机 播放 ， 还 是 得 采用 pcm 格式 。 

下 面 是 AudioRecord 的 录音 方法 说 明 。 

。 getMinBufferSize: 根据 采样 频率 、 声 道 配 置 、 音 频 格 式 获得 合适 的 缓冲 区 大 小 。 

e@ 构造 函数 : 可 设置 录音 来 源 、 采 样 频率 、 声 道 配置 、 音 频 格式 与 缓冲 区 大 小 。 其 中 录 
音 来 源 一 般 是 AudioSource.MIC， 采 样 频率 可 取 值 8000 或 者 16000， 声 道 配置 可 取 值 
AudioFormatCHANNEL_IN_STEREO 或 者 AudioFormat.CHANNEL_ OUT_STEREO， 
音频 格式 的 取 值 说 明 见 表 13-3。 

表 13-3” 音 轨 之 中 音频 格式 的 取 值 说 阴 


AudioFormat 类 的 音频 格式 说 明 

ENCODING _ PCM_16BIT 每 个 采样 块 为 16 位 数 。 推 荐 该 格式 
ENCODING_PCM_8BIT 每 个 采样 块 为 8 位 数 
ENCODING_PCM_FLOAT 每 个 采样 块 为 单 精度 浮 点 数 














startRecording: 开始 录音 。 

read: 从 缓冲 区 中 读 取 音 频数 据 ， 此 数据 用 于 保存 到 音频 文件 中 。 

stop: 停止 录音 。 

release: 停止 录音 并 释放 资源 。 

setNotificationMarkerPosition: 设置 需要 通知 的 标记 位 置 。 

setPositionNotificationPeriod: 设置 需要 通知 的 时 间 周 期 。 
setRecordPositionUpdateListener: 设置 录制 位 置 变化 的 监听 器 对 象 。 该 监听 器 从 
OnRecordPositionUpdateListener 扩展 而 来 ， 需 要 实现 的 两 个 方法 说 明 如 下 : 
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。 onMarkerReached: 在 标记 到 达 时 触发 ， 对 应 setNotificationMarkerPosition 方法 。 
e onPeriodicNotification: 在 周期 结束 时 触发 ， 对 应 setPositionNotificationPeriod 方法 。 


下 面 是 AudioTrack 的 播音 方法 说 明 。 


egetMinBufferSize: 根据 采样 频率 、 声 道 配 置 、 音 频 格 式 获得 合适 的 缓冲 区 大 小 。 

e@ 构造 函数 : 可 设置 音频 类 型 、 采 样 频率 、 声 道 配 置 、 音 频 格式 、 播 放 模式 与 缓冲 区 大 
小 。 其 中 音频 类 型 一 般 是 AudioManager.STREAM_MUSIC， 采 样 频率 、 声 道 配置 、 音 
频 格 式 与 录音 时 保持 一 致 ， 播 放 模 式 一 般 是 AudioTrack.MODE_STREAM. 

esetStereoVolume: 设置 立体 声 的 音量 。 第 一 个 参数 是 左 声 道 音量 ， 第 二 个 参数 是 右 声 
道 音量 。 

eplay: 开始 播音 。 

write: 把 缓冲 区 的 音频 数据 写 入 音 轨 。 调 用 该 函数 前 要 先 从 音频 文件 读 取 数 据 写 入 组 

冲 区 。 

stop: 停止 播音 。 

release: 停止 播音 并 释放 资源 。 

setNotificationMarkerPosition: 设置 需要 通知 的 标记 位 置 。 

setPositionNotificationPeriod: 设置 需要 通知 的 时 间 周 期 。 

setPlaybackPositionUpdateListener: 设置 播放 位 置 变 化 的 监听 器 对 象 。 该 监听 器 从 

OnPlaybackPositionUpdateListener 扩展 而 来 ， 需 要 实现 的 两 个 方法 说 明 如 下 : 

onMarkerReached: 在 标记 到 达 时 触发 ， 对 应 setNotificationMarkerPosition 方法 。 

e onPeriodicNotification: 在 周期 结束 时 触发 ， 对 应 setPositionNotificationPeriod 方法 。 


因为 音 轨 录制 直接 读 取 流 数 据 ， 如 果 没 取消 录制 ， 就 会 一 直 在 等 待 ， 所 以 适合 将 录制 任 
务 分 配 到 分 线程 处 理 ， 避 免 等 待 行为 堵塞 主线 程 。 下 面 是 音 轨 录制 线程 的 关键 代码 片段 : 


protected Void doInBackground(String... arg0) { 
File recordFile = new File(arg0[0]);，// 第 一 个 参数 是 音频 文件 的 保存 路 径 
int frequence = IntegerparseInt(arg0[1]); / 第 二 个 参数 是 音频 的 采样 频率 ， 单 位 赫兹 
int channel = Integer.parseInt(arg0[2]); / 第 三 个 参数 是 音频 的 声 道 配置 
int format = IntegerparseInt(arg0[3]); / 第 四 个 参数 是 音频 的 编码 格式 
try{ 
// 开通 输出 流 到 指定 的 文件 
DataOutputStream dos = new DataOutputStream( 
new BufferedOutputStream(new FileOutputStream(recordFile))); 
// 根据 定义 好 的 几 个 配置 ， 来 获取 合适 的 缓冲 大 小 
int bsize=AudioRecord.getMinBufferSize(frequence, channel, format); 
/ 定义 缓冲 区 
short[] buffer = new short[bsize]; 
// 根据 音频 配置 和 缓冲 区 构建 音 轨 录制 实例 
AudioRecord record = new AudioRecord(AudioSource.MIC, 
frequence, channel, format, bsize); 
// 设置 需要 通知 的 时 间 周 期 为 1 秒 
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record.setPositionNotificationPeriod(1000); 
// 设置 录制 位 置 变化 的 监听 器 
record.setRecordPositionUpdateListener(new RecordUpdateListener()); 
/ 开始 录制 音 轨 
record.startRecording(); 
// 没有 取消 录制 ， 则 持续 读 取 缓冲 区 
while (!lisCancelled()) { 
int bufferReadResult = record read(buffer 0, buffer.length); 
/ 循环 将 缓冲 区 中 的 音频 数据 写 入 到 输出 流 
for (inti=0;i<bufferReadResult i++) { 
dos.writeShort(buffer[i]); 
} 
b 
/ 取消 录制 任务 ， 则 停止 音 轨 录制 
record.stop(); 
dos.close(); 
} catch (Exception e) { 
e.printStack Trace(); 
} 
return null; 


} 
同 理 ， 音 轨 播 放 操作 也 应 当 开 启 分 线程 处 理 ， 下 面 是 音 轨 播放 线程 的 关键 代码 片段 : 


protected Void doInBackground(String... arg0) { 
File recordFile = new File(arg0[0]); / 第 一 个 参数 是 音频 文件 的 保存 路 径 
int frequence = IntegerparseInt(arg0[1]); / 第 二 个 参数 是 音频 的 采样 频率 ， 单 位 赫兹 
int channel = Integer.parseInt(arg0[2]); / 第 三 个 参数 是 音频 的 声 道 配置 
int format = IntegerparseInt(arg0[3]); / 第 四 个 参数 是 音频 的 编码 格式 
try{ 
// 定义 输入 流 ， 将 音频 写 入 到 AudioTrack 类 中 ， 实 现 播放 
DatalInputStream dis = new DataInputStream( 
new BufferedInputStream(new FileInputStream(recordFile))); 
// 根据 定义 好 的 几 个 配置 ， 来 获取 合适 的 缓冲 大 小 
int bsize = AudioTrack.getMinBufferSize(frequence, channel, format); 
// 定义 缓冲 区 
short[] buffer = new short[bsize / 4]; 
// 根据 音频 配置 和 缓冲 区 构建 音 轨 播 放 实例 
AudioTrack track = new AudioTrack(AudioManager.STREAM _ MUSIC, 
frequence, channel, format bsize, AudioTrack.MODE STREAM); 
// 设置 需要 通知 的 时 间 周 期 为 1 秒 
track.setPositionNotificationPeriod( 1000); 
/ 设置 播放 位 置 变化 的 监听 器 
track.setPlaybackPositionUpdateListener(new PlaybackUpdateListener()); 
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/ 开始 播放 音 轨 
track.play0O; 
/ 由 于 AudioTrack 播放 的 是 字 节 流 ， 所 以 ， 我 们 需要 一 边 播放 一 边 读 取 
while (!lisCancelled() && dis.available() > 0) { 
inti=0; 
/ 把 输入 流 中 的 数据 循环 读 取 到 缓冲 区 
while (dis.available() > 0 && i < buffer.length) { 
buffer[i] = dis.readShort(); 
讨 -二 
机 
/ 然后 将 数据 写 入 到 音 轨 AudioTrack 中 
track.write(buffer, 0, buffer.length); 
; 
/ 取消 播放 任务 ， 或 者 读 完了 ， 都 停止 音 轨 播 放 
track.stop(); 
dis.close(); 
} catch (Exception e) { 
e.printStack Trace(); 
} 
return null; 


} 
音 轨 录 播 的 效果 如 图 13-11 和 图 13-12 所 示 ， 其 中 图 13-11 为 正在 录制 音 轨 的 画面 ， 此 时 
上 面 文字 记录 了 当前 已 录制 的 音 轨 时 长 ; 图 13-12 为 正在 播放 音 轨 时 的 画面 ,此 时 下 面 文字 记 
录 了 当前 已 播放 的 音 轨 时 长 。 








6 秒 27 秒 
停止 录制 开始 录制 
4 秒 
开始 播放 暂停 播放 
图 13-11 音 轨 正 在 录制 图 13-12 音 轨 正在 播放 


13.3 ”视频 播放 


本 节 介 绍 视频 播放 的 相关 技术 ， 首 先 说 明 视频 视图 的 工作 原理 ， 并 结合 拖 动 条 实现 简单 
的 视频 播放 器 ， 接 着 痔 述 媒体 控制 条 的 用 法 ， 以 及 媒体 控制 条 与 视频 视图 的 两 种 绑 定 方式 ， 最 
后 演示 了 如 何 实现 自 定义 样式 的 视频 播放 控制 条 。 
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视频 视图 VideoView 


第 9 章 在 介绍 录像 放映 功能 时 使 用 了 MediaPlayer 结合 SurfaceView 播放 视频 文件 ， 其 中 
通过 SurfaceView 显示 视频 的 画面 ， 通 过 MediaPlayer 设置 播放 参数 并 控制 视频 的 播放 操作 。 
不 过 仅仅 播 一 个 视频 就 得 如 此 深入 掌握 技术 细节 未 免 太 兴 师 动 众 了 , 因此 Android 推出 了 视频 
视图 VideoView， 该 控件 内 部 集成 了 SurfaceView 和 MediaPlayer， 从 而 实现 视频 画面 与 视频 操 
作 的 统一 管理 ， 为 开发 者 进行 视频 开发 提供 便利 。 

下 面 是 VideoView 的 常用 方法 说 明 。 

e setVideoPath: 设置 视频 文件 的 路 径 。 


e@ setMediaController: 设置 媒体 控制 条 的 对 象 。 
esetOnPreparedListener: 设置 预备 播放 监听 器 。 需 实现 监听 器 OnPreparedListener 的 


onPrepared 方法 ， 该 方法 在 准备 播放 时 调用 。 

setOnCompletionListener: 设置 结束 播放 监听 器 。 需 实现 监听 器 OnCompletionListener 
的 onCompletion 方法 ， 该 方法 在 结束 播放 时 调用 。 

setOnErrorListener: 设置 播放 异常 监听 器 。 需 实现 监听 器 OnErrorListener 的 onError 
方法 ， 该 方法 在 播放 出 现 异 常 时 调用 。 

setOnInfoListener: 设置 播放 信息 监听 器 。 需 实现 监听 器 OnInfoListener 的 onInfo 方法 ， 
该 方法 在 播放 需要 传递 某 种 消息 时 调用 ， 如 开始 /结束 缓冲 。 

requestFocus: 请 求 获得 焦点 。 该 方法 要 在 start 方法 前 调用 。 

start: 开始 播放 视频 。 

pause: 暂停 播放 视频 。 

resume: 恢复 播放 视频 。 

suspend: 结束 播放 并 释放 资源 。 

seekTo: 拖 动 视频 到 指定 进度 开始 播放 。 

getDuration: 获得 视频 的 总 时 长 。 

getCurrentPosition: 获得 当前 的 播放 位 置 。 该 方法 返回 值 与 getDuration 相等 时 ， 表 示 
播放 到 了 末尾 。 

isPlaying: 判断 是 否 正在 播放 。 


。 getBufferPercentage: 获得 已 缓冲 的 比例 。 返 回 值 在 0 到 1 之 间 。 


由 于 VideoView 只 是 一 个 播放 界面 ， 本 身 不 会 显示 进度 条 ， 因 此 实际 开发 中 至 少 得 给 它 
配备 一 个 拖 动 条 SeekBar， 一 方面 用 来 展示 当前 的 播放 进度 ， 另 一 方面 用 来 拖 动 播放 位 置 。 

在 VideoView 的 方法 中 ，SeekBar 主要 用 到 了 三 个 方法 ， 第 一 个 getDuration 方法 获得 的 
总 时 长 对 应 拖 动 条 的 最 大 进度 值 ， 第 二 个 getCurrentPosition 方法 对 应 拖 动 条 的 当前 进度 值 ， 
第 三 个 seekTo 方法 是 在 用 户 拖 动 SeekBar 结束 后 调用 。 为 VideoView 加 上 SeekBar， 即 可 实 
现 基本 的 播放 控制 操作 。 

下 面 是 使 用 VideoView 结合 SeekBar 的 代码 ， 相 比 第 9 章 的 放映 代码 明显 精简 许多 : 


public class VideoViewActivity extends AppCompatActivity implements 


OnClickListener, FileSelectCallbacks, OnSeekBarChangeListener { 
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private VideoView vv_play; / 声明 一 个 视频 视图 对 和 象 
private SeekBar sb_ play; / 声明 一 个 拖 动 条 对 象 
private HandlermHandler= new Handler(0); / 声明 一 个 处 理 器 对 象 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_video_view); 
findViewById(R.id.btn_open).setOnClickListener(this); 
// 从 布局 文件 中 获取 名 叫 vv_content 的 视频 视图 
Vv_play =findViewById(R.id.vv_content); 
/ 从 布局 文件 中 获取 名 叫 sb_play 的 拖 动 条 
sb_play = findViewById(R.id.sb_play); 
/ 设置 拖 动 条 的 拖 动 变更 监听 器 
sb_play.setOnSeekBarChangeListener(this); 
/ 禁用 拖 动 条 
sb_play.setEnabled(false); 

b 


public void onClick(View v) { 
if (v.getId() 一 R.id.btn_open) { 
String[] videoExs = new String[]{"mp4", "3gp", "mkv" "mov", "avi"}; 
/ 打开 文件 选择 对 话 框 
FileSelectFragment.show(this, videoExs, null); 


} 


/ 点 击 文件 选择 对 话 框 的 确定 按钮 后 触发 


public void onConfirmSelect(String absolutePath, String fileName, Map<String, Object> map_param) { 


/ 拼接 文件 的 完整 路 径 
String file_path = absolutePath + "/" + fileName; 
/ 设置 视频 视图 的 视频 路 径 
vv_play.setVideoPath(file_path); 
// 视频 视图 请 求 获得 焦点 
vv_play.requestFocus(); 
/ 视频 视图 开始 播放 
YY_play.startO; 
/ 启用 拖 动 条 
sb_play.setEnabled(true); 
/ 立即 启动 进度 刷新 任务 
mHandler.post(mRefresh); 

' 


/ 检查 文件 是 否 合法 时 触发 
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public boolean isFileValid(String absolutePath, String fileName, Map<String, Object> map_param) { 
Teturn true; 


) 


/ 定义 一 个 拖 动 条 的 进度 刷新 任务 
private Runnable mRefresh = new Runnable() { 
public void run0) { 
// 通过 播放 时 长 与 当前 位 置 ， 计 算 视 频 已 播放 的 百分比 
int progress = 100 * vv_play.getCurrentPosition()/ vv_play.getDuration(); 
// 设置 拖 动 条 的 当前 进度 
sb_play.setProgress(progress); 
/ 延迟 500 毫秒 后 再 次 启动 进度 刷新 任务 
mHandler.postDelayed(this, 500); 


}; 


// 在 进度 变更 时 触发 。 第 三 个 参数 为 true 表示 用 户 拖 动 ， 为 false 表示 代码 设置 进度 
public void onProgressChanged(SeekBar seekBar int progress, boolean fromUser) {} 


/ 在 开始 拖 动 进度 时 触发 

public void onStartTrackingTouch(SeekBar seekBar) {} 

// 在 停止 拖 动 进度 时 触发 

public void onStopTrackingTouch(SeekBar seekBar) { 
/ 通过 进度 百分比 与 播放 时 长 ， 计 算 视 频 当前 的 播放 位 置 
int pos = seek Bar.getProgress() * vv_play.getDuration()/ 100; 
// 命令 视频 视图 从 指定 位 置 开 始 播放 
VV_play.seekTo(pos); 


} 

VideoView 与 SeekBar 的 播放 效果 如 图 13-13 和 图 13-14 所 示 。 其 中 ， 如 图 13-13 所 示 为 
视频 播放 开始 的 画面 ， 此 时 拖 动 条 的 进度 图 标 尚 在 左边 ， 如 图 13-14 所 示 为 视频 播放 即将 结束 
的 画面 ， 此 时 拖 动 条 的 进度 图 标 已 经 移 到 右边 了 。 


media 


打开 视频 文件 


人 














图 13-13 视频 视图 刚刚 开始 播放 图 13-14 视频 视图 即将 结束 播放 
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13.3.2 ”媒体 控制 条 MediaController 


使 用 拖 动 条 主要 完成 两 个 播放 控制 功能 : 显示 当前 播放 进度 和 拖 动 到 指定 位 置 播放 。 这 
两 个 基本 功能 显然 不 够 全 面 ， 对 于 一 个 视频 播放 器 来 说 ， 至 少 还 得 实现 下 列 基础 功能 


(1) 暂停 功能 和 暂停 之 后 的 恢复 播放 功能 
(2) 查看 视频 的 总 时 长 和 当前 已 播放 的 时 长 。 
(3) 快 进 和 快 退 功能 。 


前 面 介绍 VideoView 的 常用 方法 时 提 到 setMediaController 方 法 可 设置 媒体 控制 条 的 对 象 ， 
这 个 媒体 控制 条 就 是 MediaController， 它 的 界面 跟 Windows 上 的 播放 条 几乎 一 模 一 样 ， 并 支 
持 一 些 基 本 的 播放 控制 操作 : 显示 当前 的 播放 进度 、 拖 动 到 指定 位 置 播放 、 暂 停 播放 与 恢复 播 
放 、 查 看 视频 的 总 时 长 和 已 播放 时 长 、 对 视频 做 快 进 或 快 退 操作 等 。 

下 面 是 MediaController 的 常用 方法 说 明 。 


e@ setMediaPlayer: 设置 媒体 播放 器 的 对 象 , 即 VideoView 对 象 。 该 方法 与 setAnchorView 
只 能 调用 一 个 。 

e@ setAnchorView: 设置 绑 定 的 主 视图 ， 其 实 一 般 是 一 个 VideoView 对 象 。 该 方法 与 

setMediaPlayer 只 能 调用 一 个 。 

show: 显示 媒体 控制 条 。 

hide: 隐藏 媒体 控制 条 。 

isShowing: 判断 媒体 控制 条 是 否 正在 显示 。 

setPrevNextListeners: 设置 前 一 个 按钮 与 后 一 个 按钮 的 点 击 监听 器 (OnClickListener ) 。 

如 果 没 调用 该 方法 ， 那 么 前 一 个 按钮 与 后 一 个 按钮 都 不 会 展示 。 

VideoView 继承 自 SurfaceView， 而 MediaController 继承 自 FrameLayout， 理 论 上 这 两 个 
控件 是 可 以 随意 摆 放 的 , 但 是 考虑 到 用 户 的 使 用 习惯 , 往往 将 其 集成 在 一 起 展示 ， 即 媒体 控制 
条 固定 放 在 视频 视图 的 底部 。 因 此 无 须 在 布局 文件 中 声明 MediaController 控件 ， 只 需 声明 
VideoView 控件 , 然后 在 代码 中 将 媒体 控制 条 附着 于 视频 视图 即 可 。 甚 至 布局 文件 中 都 不 用 声 
明 VideoView， 在 代码 中 动态 添加 视频 视图 和 媒体 控制 条 即 可 。 由 此 衍生 出 VideoView 与 
MediaController 的 两 种 集成 方式 : 在 布局 文件 中 声明 VideoView 和 在 代码 中 动态 添加 
VideoView。 


1. 在 布局 文件 中 声明 VideoView 


视频 视图 对 象 的 使 用 步骤 不 变 ， 即 先 调用 setVideoPath 方法 指定 视频 文件 ， 然 后 调用 
setMediaController 方法 指定 控制 条 ， 最 后 调用 start 方法 开始 播放 。 此 时 媒体 控制 条 对 象 在 完 
成 构建 后 只 需 调用 setMediaPlayer 方法 设置 播放 器 对 象 即 可 。 
该 方式 的 控件 集成 代码 如 下 : 
// 点 击 文件 选择 对 话 框 的 确定 按钮 后 触发 
public void onConfirmSelect(String absolutePath, String fileName, Map<String, Object> map_param) { 
/ 拼接 文件 的 完整 路 径 
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String file_path = absolutePath + "/" + fileName; 
/ 设置 视频 视图 的 视频 路 径 
VV_content.setVideoPath(file_ path); 

/ 视频 视图 请 求 获得 焦点 
Vv_content.requestFocus(); 

/ 创建 一 个 媒体 控制 条 

MediaController mc_play = new MediaController(this); 
/ 给 视频 视图 设置 相关 联 的 媒体 控制 条 
Vv_content.setMediaController(mce_play); 

/ 给 媒体 控制 条 设置 相关 联 的 视频 视图 
mce_play.setMediaPlayer(vv_content); 

/ 视频 视图 开始 播放 

Vv_content.start(); 


} 
2. 在 代码 中 动态 添加 VideoView 


视频 视图 对 象 需要 在 代码 中 构建 并 添加 ， 其 余 使 用 步骤 同上 。 此 时 媒体 控制 条 对 象 的 使 
用 步骤 发 生变 化 ， 不 再 调用 setMediaPlayer 方法 ， 而 改 成 调用 setAnchorView 方法 ， 该 方法 把 
媒体 控制 条 添加 到 宿主 视图 上 ， 如 果 方 法 参数 是 一 个 VideoView 对 象 ， 就 将 媒体 控制 条 添加 
到 VideoView 的 上 级 视图 。 
该 方式 的 控件 集成 代码 如 下 : 
// 点 击 文件 选择 对 话 框 的 确定 按钮 后 触发 
public void onConfirmSelect(String absolutePath, String fileName, Map<String, Object> map_param) { 

/ 拼接 文件 的 完整 路 径 

String file_path = absolutePath + "/" + fileName; 

/ 创建 一 个 视频 视图 

VideoView vv_content = new VideoView(this); 

/ 设置 视频 视图 的 视频 路 径 

Vv_content.setVideoPath(file_path); 

/ 视频 视图 请 求 获得 焦点 

Vv_content.requestFocus(); 

/ 创建 一 个 媒体 控制 条 

MediaController mc_play = new MediaController(this); 

/ 给 媒体 控制 条 设置 绑 定 的 主 视图 (一 般 是 视频 视图 ) 

me _play.setAnchorView(vv_content); 

// 给 视频 视图 设置 相关 联 的 媒体 控制 条 

Vv_content.setMediaController(me_play); 

/ 把 视频 视图 添加 到 线性 视图 上 

ll_play.addView(vv_content); 

/ 视频 视图 开始 播放 

Vv_content.start(); 
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两 种 集成 方式 的 屏幕 画面 基本 一 致 ， 开 发 者 可 根据 视频 的 展示 位 置 决 定 采 用 哪 一 种 方式 。 
视频 播放 开始 时 不 会 显示 媒体 控制 条 , 只 有 用 户 点 击 视频 画面 后 才 会 弹出 控制 条 ; 如 果 过 了 几 
秒 没 有 操作 控制 条 ， 它 就 会 自动 消失 。 

集成 后 的 播放 效果 如 图 13-15 和 图 13-16 所 示 。 其 中 ， 如 图 13-15 所 示 为 视频 播放 一 开始 
的 画面 ， 不 点 击 视频 画面 就 不 会 出 现 媒体 控制 条 ;如 图 13-16 所 示 为 点 击 视频 画面 后 的 截图 ， 
点 击 后 弹出 媒体 控制 条 ， 即 可 进行 视频 播放 的 控制 操作 。 





media media 


打开 视频 文件 打开 视频 文件 


Sp, 





图 13-15 媒体 控制 条 已 隐藏 图 13-16 媒体 控制 条 已 弹出 来 
13.3.3” 自 定义 播放 控制 条 


上 一 小 节 介 绍 了 系统 自 带 的 媒体 控制 条 MediaController， 不 过 该 控件 的 浆 端 是 显而易见 
的 ， 缘 于 MediaController 只 提供 基本 的 播放 控制 ， 却 无 法 进行 其 他 个 性 化 的 定制 ， 比 如 以 下 
功能 就 不 支持 : 

(1) 控制 条 分 上 下 两 行 ， 上 面 是 控制 按钮 ， 下 面 是 进度 条 ， 高 度 太 宽 了 ， 有 但 观瞻 。 

(2) 按钮 样式 无 法 定制 ， 且 不 能 增加 新 按钮 ， 也 无 法 删除 按钮 。 

(3) 进度 条 与 播放 时 间 的 样式 也 不 能 定制 。 

因为 媒体 控制 条 的 内 部 控件 都 是 私有 的 ， 即 使 继承 了 也 无 法 修改 ， 所 以 只 能 自己 写 个 全 
新 的 视频 控制 条 VideoController。 好 在 上 述 功能 只 是 更 改 控制 条 的 样式 , 并 未 增加 复杂 的 功能 ， 
所 以 视频 控制 条 提供 以 下 控件 即 可 满足 要 求 : 

(1) 一 个 播放 按钮 ， 点 击 按钮 暂停 播放 ， 再 点 击 恢复 播放 。 

(2) 一 个 拖 动 条 ， 动 态 显示 当前 的 播放 进度 ， 并 允许 把 视频 拖 动 到 指定 位 置 开 始 播放 。 

(3) 两 个 文本 控件 ， 一 个 显示 视频 的 总 时 长 ， 另 一 个 显示 视频 的 已 播放 时 长 。 











放 进 度 。 对 于 视频 视图 向 控制 条 通知 播放 进度 , 可 以 设置 定时 器 持续 刷新 播放 进度 ; 对 于 控制 
条 向 视频 视图 通知 播放 动作 ， 可 以 监听 播放 按钮 的 点 击 事件 ， 以 及 拖 动 条 的 拖 动 事件 ， 并 将 事 
件 处 理 结果 传 给 视频 视图 VideoView 对 象 。 
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比如 下 面 的 代码 演示 了 视频 视图 如 何 将 播放 进度 同步 给 视频 控制 条 : 


private HandlermHandler= new Handler(0); / 声明 一 个 处 理 器 对 象 
// 定义 一 个 控制 条 的 进度 刷新 任务 。 实 时 刷新 控制 条 的 播放 进度 ， 每 隔 0.5 秒 刷新 一 次 
private Runnable mRefresh = new Runnable() { 
public void run() { 
让 (vv_content.isPlaying()) { / 视频 视图 正在 播放 
/ 给 视频 控制 条 设置 当前 的 播放 位 置 和 缓冲 百分比 
ve_play.setCurrentTime(Vv_content.getCurrentPosition(), 
Vv_content.getBufferPercentage()); 
} 
// 延迟 500 毫秒 后 再 次 启动 进度 刷新 任务 
mHandler.postDelayed(this, 500); 


上 
又 如 下 面 的 代码 片段 演示 了 视频 控制 条 如 何 把 拖 动 位 置 告 知 视频 视图 : 


private VideoView mVideoView; / 声明 一 个 视频 视图 对 象 
private int mDuration = 0 / 视频 的 播放 时 长 ， 单 位 毫秒 


/ 为 视频 控制 条 设置 关联 的 视频 视图 ， 同 时 获取 该 视频 的 播放 时 长 
public void setVideoView(VideoView view) { 

mVideoView = view:; 

mDuration = mVideoView.getDuration(); 


} 


// 在 进度 变更 时 触发 。 第 三 个 参数 为 true 表示 用 户 拖 动 ， 为 false 表示 代码 设置 进度 
// 如 果 是 人 为 的 改变 进度 〈 即 用 户 拖 动 进度 条 )， 则 令 视 频 从 指定 时 间 点 开始 播放 
public void onProgressChanged(SeekBar seekBar int progress, boolean fromUser) { 
if (fromUser) { 

/ 计算 拖 动 后 的 当前 时 间 进 度 

int time = progress * mDuration / 100; 

// 拖 动 播放 器 的 当前 进度 到 指定 位 置 

mVideoView.seek To(time); 


| 


另外 注意 ， 倘 若 用 户 中 途 切 换 去 别 的 App 办 理事 情 ， 那 么 视频 播放 App 要 及 时 保存 当前 
的 播放 进度 , 以 便 用 户 切 换 回来 之 时 能 够 正常 延续 播放 。 相应 改写 后 的 页 面 暂停 与 恢复 方法 如 
下 所 示 : 


private int mCurrentPosition = 0; / 当前 的 播放 位 置 





protected void onResume() { 
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super.onResume(); 

// 恢复 页 面 时 立即 从 上 次 断 点 开始 播放 视频 

if (mCurrentPosition>0 && !vv_contentisPlayingO) { 
// 命令 视频 视图 从 指定 位 置 开 始 播放 
Vv_content.seek To(mCurrentPosition); 
/ 视频 视图 开始 播放 
Vv_content.start(); 


} 


protected void onPause() { 
super.onPause(); 
/ 暂停 页 面 时 保存 当前 的 播放 进度 
让 (vv_content.isPlaying0) { // 视频 视图 正在 播放 
/ 获得 视频 视图 当前 的 播放 位 置 
mCurrentPosition = vy_content.getCurrentPosition(); 
// 视频 视图 暂停 播放 


vv_content.pause(); 


} 


按照 上 述 需求 重新 定制 后 的 视频 控制 条 ， 它 的 界面 效果 如 图 13-17 和 图 13-18 所 示 ， 其 中 
图 13-17 为 正在 播放 时 的 完整 视频 画面 ， 图 13-18 为 暂停 播放 时 的 完整 视频 画面 。 





0 











图 13-17 正在 播放 时 的 视频 画面 图 13-18 暂停 播放 时 的 视频 画面 





13.4 多 窗口 


由 于 观看 视频 经 常 占 据 整 个 屏幕 ， 因 此 造成 用 户 难 以 兼顾 其 他 App 的 事务 。 假 设 看 视频 
的 时 候 突然 收 到 一 条 微 信 消 息 , 用 户 应 该 怎么 处 理 ? 如 果 忍 痛 割 爱 暂 停 视频 , 转 去 微 信 答复 消 
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息 ， 观 影 的 兴致 顿时 索然 ; 如 果 不 理会 微 信 消息 ， 继 续 观赏 影片 ， 则 可 能 导致 好 友 怪罪 ， 殊 为 
不 便 。 故 而 理想 的 状态 是 一 边 看 电影 一 边 发 消息 ， 两 边 都 不 耽误 ， 这 就 要 求 手 机 屏幕 允许 分 成 
多 个 窗口 , 每 个 任务 使 用 一 个 小 窗 ,， 如 此 才能 达成 多 项 事务 并 行 不 悖 的 目标 。 为 了 实现 将 屏幕 
分 窗口 运行 的 功能 , 可 采取 分 屏 、 画 中 画 、 自 定义 悬浮 窗 等 技术 手段 , 下面 分 别 进行 详细 介绍 。 


13.4.1 分 屏 一 一 多 窗口 模式 





现在 的 手机 屏幕 越 来 越 大 ， 使 得 在 屏幕 上 同时 开 多 个 窗口 不 再 奢侈 ， 因 此 Android 从 7.0 
开始 顺势 推出 了 分 屏 功能 ， 也 被 称 作 多 窗口 模式 。 比 如 把 竖 长 的 手机 屏幕 分 成 上 下 两 个 窗口 ， 
- 边 在 上 面 的 窗口 中 观看 电影 ,一 边 在 下 面 的 窗口 中 聊天 ， 可 谓 娱 乐 、 工 作 两 不 误 。 那么 分 屏 
功能 需要 开发 者 进行 哪些 适 配 工 作 呢 ? 接 下 来 就 详细 阑 述 如 何 开关 分 屏 模式 ,以 及 在 编码 的 时 
候 有 哪些 注意 的 地 方 。 
首先 准备 一 部 Android 7.0 及 以 上 版 本 的 手机 ， 按 下 屏幕 底部 的 任务 键 ， 此 时 屏幕 下 方 会 
弹出 一 排 的 任务 列表 。 这 个 任务 界面 仿佛 跟 低 版 本 的 手机 没什么 不 同 ,再 隔 枉 屏幕 上 方 有 没有 
什么 异样 ， 是 不 是 在 左上 角 看 到 了 如 图 13-19 所 示 的 一 个 “分 屏 模式 ”的 按钮 ? 点 击 该 按钮 ， 
这 时 屏幕 上 方 变 了 一 排 的 颜色 ， 还 有 文字 提示 “ 拖 动 应 用 到 此 处 ”， 如 图 13-20 所 示 好 像 看 电 
影 拉 下 了 一 片 幕 布 。 





图 13-19 按 下 任务 键 提示 分 屏 模式 


拖 动 应 用 到 此 处 





图 13-20 ”已 经 开启 分 屏 模式 的 桌面 


然后 用 手指 从 下 面 拖 动 一 个 任务 拉 到 这 块 幕布 区 域 ， 该 任务 的 界面 立即 填 满 了 屏幕 的 上 
半 部 分 。 继 续 点 击 任务 列表 里 的 任何 一 个 App， 此 刻 被 选中 的 App 马上 展示 到 了 屏幕 的 下 半 
部 分 。 于 是 整个 手机 屏幕 分 成 了 如 图 3-21 所 示 的 上 下 两 个 窗口 ,每 个 窗口 各 自 运行 自己 的 App 
界面 ， 从 而 实现 了 对 屏幕 进行 分 屏 的 操作 。 

分 屏 后 的 两 个 App,， 用 户 可 以 像 往常 一 样 点 击 、 刷 新 和 后 退 。 要 是 玩 腻 了 分 屏 ， 也 可 按 下 
任务 键 ， 此 时 屏幕 顶端 中 央 浮 现 出 了 如 图 13-22 所 示 的 一 个 “退出 分 屏 ” 的 按钮 ， 点 击 该 按钮 
即 可 恢复 原来 的 全 屏 模式 。 
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创建 便签 实 私密 便签 
便签 夹 可 以 帮助 您 您 可 以 将 需要 保 社 











图 3-21 应 用 进入 分 屏 模式 图 13-22 ”准备 退出 分 屏 模式 


以 上 的 演示 步骤 ， 是 教 用 户 如 何 开 启 和 关闭 全 屏 模 式 。 对 于 开发 者 来 说 
出 了 以 下 的 编码 步骤 建议 : 


，Android 官方 给 


CT01 一 般 情况 下 ，App 默认 都 允许 分 屏 模式 。 但 有 的 开发 者 认为 自己 的 App 只 有 在 全 屏 


























状态 下 才能 正常 使 用 ， 要 是 被 分 屏 的 话 用 起 来 会 很 难受 ， 这 时 候 就 得 对 该 App 


禁用 分 屏 模式 。 具 





体操 作 是 在 AndroidManifest.xml 的 application 节点 添加 属性 android:resizeableActivity="false"， 表 














示 应 用 页 面 不 接受 分 屏 ; 如 此 一 来 , 即使 用 户 开 启 了 分 屏 模 式 , 切换 到 该 应 用 时 
模式 。 

CV02 App 页 面 从 全 屏 模式 切换 到 分 屏 模式 , 它 的 Activity 生命 周期 会 经 
程 ， 如 果 开 发 者 想 保持 App 页 面 在 分 屏 前 的 模样 ， 则 需 给 该 页 面 的 activity 节点 
述 ， 告 知 系统 不 要 对 这 个 页 面 动手 动 脚 : 


android:configChanges="screenLayoutlorientation" 














仍 会 强制 回 到 全 屏 








历 销毁 后 重建 的 过 
加 上 以 下 的 属性 描 





G703 对 于 视频 播放 页 面 ， 建 议 Activity 代码 不 在 onPause 方法 中 暂停 播放 视频 ， 而 应 当 在 





onStop 方法 中 暂停 播放 ， 并 在 onStart 方法 中 恢复 播放 视频 。 


人 4 App 运行 过 程 中 ， 若 想 获 知 当前 是 否 处 于 分 屏 模式 ， 则 可 调用 isInMultiWindowMode 














方法 ， 该 方法 返回 true 表示 处 于 分 屏 模式 ， 返 回 false 表示 处 于 全 屏 模 式 。 
G105 每 当 进 入 多 窗口 ， 或 者 退出 多 窗口 的 时 候 ， 应 用 会 触发 























Activity 页 面 的 











onMultiWindowModeChanged 方法 。 通 过 重 载 该 方法 ， 应 用 可 以 即时 收 到 分 屏 与 全 屏 的 切换 通知 。 





然而 上 面 的 编码 建议 只 给 出 了 结果 ， 却 没 说 明 原因 ， 着 实 令 人 云 里 雾 是 





县 。 为 更 好 地 理解 


分 屏 时 候 的 业务 流程 ， 读 者 不 妨 在 Activity 代码 中 打印 生命 周期 的 每 个 方法 日 志 ， 从 而 观察 发 
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现 其 中 的 缘由 。 笔 者 这 边 补 充 日 志 打印 后 的 观察 结果 如 下 : 


(1) App 未 增加 任何 分 屏 设 置 ， 则 按 下 任务 键 后 的 生命 周期 为 “onPause 一 onStop”; 接 

着 把 App 拖 进 分 屏 窗口 ， 此 时 的 生命 周期 为 “onDestroy 一 onCreate 一 onStart 一 onStart 一 
onMultiWindowModeChanged 一 onResume”。 

(2) App 的 页 面 在 activity 节点 设置 configChanges 属性 ， 则 按 下 任务 键 后 的 生命 周期 仍 
为 “onPause 一 onStop”， 但 拖 进 分 屏 窗口 时 候 的 生命 周期 变更 为 “onStart 一 onResume”。 

(3) 分 屏 模 式 之 下 ， 先 把 A 应 用 拖 到 上 面 的 分 窗口 ， 再 在 下 面 的 分 窗口 中 打开 B 应 用 ， 

志 显 示 A 应 用 经 历 了 “onPause 一 onResume” 的 过 程 。 这 是 因为 Android 在 任 一 时 刻 只 能 有 

唯一 的 Activity 处 于 活动 状态 ， 分 屏 模式 下 打开 B 应 用 的 时 候 ， 系 统 会 先 暂 停 A 的 页 面 ， 然 
后 加 载 B 的 页 面 ， 等 到 B 页 面 加 载 完 ， 才 去 恢复 A 页 面 。 

从 上 述 的 观察 结果 可 知 ,App 的 多 数 功能 不 受 分 屏 生 命 周期 的 影响 ,但 视频 播放 是 个 例外 。 
因为 通常 开发 者 会 在 页 面 暂 停 时 也 暂停 播放 视频 , 等 到 页 面 恢复 时 再 恢复 播放 视频 。 可 是 一 旦 
遇 到 分 屏 的 情况 , 用 户 一 边 看 视频 , 一 边 在 另 一 个 窗口 办 事 , 这 意味 着 视频 播放 页 面 会 经 常 处 
于 “ 先 暂 停 再 恢复 ”的 状态 。 尽 管 只 有 少数 情况 才 会 产生 明显 的 卡 顿 现象 ， 多数 情况 用 户 难 以 
意识 到 微小 的 中 断 ， 但 这 对 手机 而 言 却 是 巨大 的 资源 消耗 因此 处 理 视频 播放 的 时 候 ， 最 好 在 
onStop 方法 中 停止 播放 ， 在 onStart 方法 中 恢复 播放 ， 这 样 才能 避免 分 屏 带 来 的 中 断 困扰。 

总 结 一 下 ，Android7.0 带 来 的 分 屏 功 能 ， 主 要 影响 到 视频 播放 页 面 的 编码 ， 具 体 来 说 要 进 
行 以 下 两 个 步骤 的 修改 : 


EXR) 对 于 视频 播放 页 面 ， 需 要 在 它 的 activity 节点 加 上 如 下 属性 描述 ， 表 示 分 屏 与 全 屏 切 
换 之 时 保持 视频 页 的 内 容 : 
android:configChanges="screenLayoutlorientation" 
C702 过 到 生命 周期 变化 导致 视频 暂停 和 恢复 播放 的 情况 ， 要 在 onStop 方法 中 暂停 播放 视 
频 ， 而 不 是 在 onPause 方法 中 暂停 ; 同 理 ， 要 在 onStart 方法 中 恢复 播放 视频 ， 而 不 是 在 onResume 
方法 中 恢复 ， 以 避免 无 谓 的 资源 浪费 。 改 写 后 的 视频 播放 控制 代码 示例 如 下 : 


private int mCurrentPosition = 0; / 当前 的 播放 位 置 

















/ 兼容 分 屏 模式 。 当 前 页 面 被 拖 到 分 屏 窗 口中 ， 就 立即 恢复 播放 视频 
protected void onStartO { 
super.onStart(); 
// 恢复 页 面 时 立即 从 上 次 断 点 开始 播放 视频 
if (mCurrentPosition>0 && !vv_contentisPlayingO) { 
// 命令 视频 视图 从 指定 位 置 开 始 播放 
VV_content.seek To(mCurrentPosition); 
vv_content.start0; / 视频 视图 开始 播放 


} 


/ 兼容 分 屏 模 式 。App 处 于 停止 状态 时 ， 则 保存 当前 的 播放 进度 
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protected void onStop() { 
super.onStop(); 
/ 暂停 页 面 时 保存 当前 的 播放 进度 
让 (vv_contentisPlaying0) { / 视频 视图 正在 播放 
/ 获得 视频 视图 当前 的 播放 位 置 
mCurrentPosition = vy_content.getCurrentPosition(); 
vv_content.pause0; / 视频 视图 暂停 播放 


} 
13.4.2” 画 中 男 一 一 特殊 的 多 窗口 


上 一 小 节 介 绍 了 Android 7.0 的 多 窗口 特性 ， 但 是 这 个 分 屏 的 区 域 是 固定 的 ， 要 么 在 屏幕 
的 上 半 部 分 , 要 么 在 屏幕 的 下 半 部 分 , 不 但 尺寸 无 法 调整 而 且 还 不 能 拖 动 ， 使 得 它 的 用 户 体验 
不 够 完美 。 为 此 Android8.0 又 带 了 另 一 种 更 高 级 的 多 窗口 模式 ， 号称 “Picture in Picture”( 简 
称 PIP， 即 “ 画 中 画 ”) 。 应 用 一 旦 进入 画 中 画 模式 ， 就 会 缩小 为 屏幕 上 的 一 个 小 窗口 ， 该 窗 
口 可 拖 动 可 调整 大 小 ， 非 常 适合 用 来 播放 视频 。 那 么 如 何 才能 让 App 支持 画 中 画 呢 ? 接 下 来 
将 对 画 中 画 的 开发 工作 进行 详细 介绍 。 

经 过 前 面 的 学 习 ， 大 家 知道 Activity 默认 是 支持 分 屏 模式 的 ， 当 然 开发 者 手工 给 activity 
节点 添加 下 面 的 属性 描述 ， 从 而 声明 允许 分 屏 也 是 可 以 的 : 

android:resizeableActivity="true" 

但 是 对 于 画 中 画 来 说 ，Activity 默认 不 支持 该 模式 。 若 想 让 App 页 面 能 够 显示 画 中 画 的 效 
果 ， 则 必须 给 activity 节点 添加 下 面 的 属性 描述 ， 表 示 该 页 面 支持 画 中 画 模式 : 

android:supportsPictureInPicture="true" 

除了 画 中 画 模 式 的 属性 声明 ， 与 分 屏 模式 类 似 ， 画 中 画 还 需 注意 进行 以 下 步 又 处 理 : 

201 App 页 面 从 全 屏 模 式 切换 到 画 中 画 模式 , 它 的 Activity 生命 周期 也 会 经 历 销毁 后 重建 
的 过 程 , 如 果 开 发 者 想 保持 App 页 面 不 被 重建 , 则 需 给 该 页 面 的 activity 节点 加 上 以 下 的 属性 描述 : 

android:configChanges="screenLayoutlorientation" 

C302 对 于 视频 播放 页 面 ，Activity 代码 同样 不 在 onPause 方法 中 暂停 播放 视频 ， 而 应 当 在 
onStop 方法 中 暂停 播放 ， 并 在 onStart 方法 中 恢复 播放 视频 。 

C303 App 若 想 获知 当前 是 否 处 于 画 中 画 模 式 , 则 可 调用 isInPictureInPictureMode 方法 ,该 
方法 返回 true 表示 处 于 画 中 男模 式 ， 返 回 false 表示 处 于 全 屏 模式 。 

C04 每 当 App 进入 画 中 画 ， 或 者 退出 画 中 画 的 时 候 ， 应 用 会 触发 Activity 页 面 的 
onPictureInPictureModeChanged 方法 。 通 过 重 载 该 方法 ， 应 用 可 以 实时 收 到 画 中 画 与 全 屏 的 切换 通 
知 , 并 在 此 控制 控件 的 展示 。 比如 进入 画 中 画 时 , 隐藏 除 视频 画面 之 外 的 所 有 控件 ; 退出 画 中 画 时 ， 
则 恢复 这 些 控件 的 正常 显示 ， 具 体 参见 下 列 代码 : 


// 在 进入 画 中 夯 模式 /退出 画 中 画 模式 时 触发 
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public void onPictureInPictureModeChanged(boolean isInPicInPicMode, Configuration newConfig) { 

super.onPictureInPictureModeChanged(isInPicInPicMode, newConfig); 

让 (isInPicInPiceMode) { / 进入 画 中 画 模 式 ， 则 隐藏 除 视频 画面 之 外 的 其 他 控件 
ll_btn.setVisibility(View.GONE); 
ve_play.setVisibility(View.GONE); 

} else { // 退出 画 中 画 模 式 ， 则 显示 除 视频 画面 之 外 的 其 他 控件 
ll_btn.setVisibility(View.VISIBLE); 
ve_play.setVisibility(View.VISIBLE); 





| 
上 面 废话 了 这 么 多 ， 可 是 怎样 才能 让 应 用 进入 画 中 画 模 式 呢 ? 按 下 任务 键 并 点 击 “ 分 屏 
模式 ”按钮 ， 接 着 把 App 拖 到 分 屏 区 域 ， 即 可 实现 分 屏 模式 的 切换 。 然 而 系统 却 没 提供 “ 画 
中 画 模式 ”之 类 的 按钮 ， 就 无 法 在 桌面 把 应 用 拖 入 画 中 画 ， 只 能 在 App 内 部 通过 代码 切 到 画 
中 画 模式 。 详 细 的 画 中 画 进入 代码 如 下 所 示 : 
/ 进入 画 中 画 模 式 
private void enterPicInPic() { 
/ 创建 画 中 画 模式 的 参数 构建 器 
PictureInPictureParams.Builder builder = new PictureInPictureParams.Builder(); 
/ 设置 宽 高 比例 值 ， 第 一 个 参数 表示 分 子 ， 第 二 个 参数 表示 分 母 
/ 下 面 的 10/5=2， 表 示 画 中 画 窗 口 的 宽度 是 高 度 的 两 倍 
Rational aspectRatio = new Rational(10,5); 
/ 设置 画 中 画 窗口 的 宽 高 比例 
builder.setAspectRatio(aspectRatio); 
/ 进入 画 中 画 模式 ， 注 意 enterPictureInPictureMode 是 Android 8.0 之 后 新 增 的 方法 
enterPictureInPicture Mode(builder.build()); 
) 


运行 测试 App， 打 开 视 频 文件 开始 播放 ， 此 时 的 播放 界面 如 图 13-23 所 示 。 





打开 视频 文件 进入 画 中 画 模 式 





图 13-23 正常 模式 下 的 视频 播放 画面 
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然后 点 击 “ 进 入 画 中 画 模式 ”按钮 ， 此 时 整个 页 面 缩小 成 屏幕 右 下 角 的 一 块 矩 形 窗口 ， 
将 该 视频 窗口 拖 动 到 屏幕 上 方 ， 可 见 如 图 13-24 所 示 悬 浮 窗 效果 。 若 要 退出 画 中 画 模式 ， 则 可 
点 击 缩小 了 的 画 中 画 窗口 , 如 图 13-25 所 示 这 时 该 窗口 放大 些许 且 画 面 呈 现 灰 影 ， 表 示 此 刻画 
中 画 横 式 正 处 于 控制 操作 。 看 到 窗口 右上 角 出 现 又 号 ， 如 果 点 击 又 号 即 可 关闭 窗口 ; 窗口 中 央 
出 现 四 角 正 方形 ， 如 果 继 续 点 击 窗口 区 域 ， 则 退出 画 中 画 并 恢复 正常 页 面 。 








图 13-24 已 经 进入 画 中 画 模式 图 13-25 ”准备 退出 画 中 画 模式 
看 起 来 感觉 不 错 ， 尤 其 是 大 屏 手 机 体验 更 佳 。 


13.4.3” 自 定义 悬浮 窗 


不 管 是 分 屏 还 是 画 中 画 ， 都 存在 着 局 限 性 ， 一 方面 窗口 的 位 置 和 大 小 比较 固定 ， 另 一 方 
面 只 有 Android 7 乃至 Android 8 系统 才 支 持 。 于 是 开发 者 创造 了 一 种 更 灵活 的 窗口 形式 ， 这 
便 是 自 定义 悬浮 窗 。 其 实 每 个 App 页 面 都 是 一 个 Window 窗口 ， 许 多 的 Window 对 象 需要 一 
个 管家 来 打 理 ， 这 个 管家 被 称 作 窗 口 管理 器 WindowManager。 在 手机 屏幕 上 新 增 或 删除 页 面 
窗口 ， 都 可 以 归结 为 WindowManager 的 操作 ， 下 面 是 该 管理 类 的 常用 方法 说 明 。 

e getDefaultDisplay: 获取 默认 的 显示 屏 信息 。 通 常 可 用 该 方法 获取 屏幕 分 辩 率 。 

e@ addView: 往 窗口 添加 视图 。 第 二 个 参数 为 WindowManager.LayoutParams 对 象 。 

。 updateViewLayout: 更 新 指定 视图 的 布局 参数 。 第 二 个 参数 为 WindowManager. 

LayoutParams 对 象 。 
ee removeView: 从 窗口 移 除 指定 视图 。 


下 面 是 窗口 布局 参数 WindowManager.LayoutParams 的 常用 属性 说 明 。 


。 alpha: 窗口 的 透明 度 ， 取 值 为 0.0 到 1.0。0.0 表示 全 透明 ，1.0 表示 不 透明 。 
e gravity: 内 部 视图 的 对 齐 方式 。 取 值 同 View 的 setGravity 方法 。 
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ex 和 y: 分 别 表示 窗口 左上 角 的 X 坐标 和 YY 坐标 。 

e width 和 height: 分 别 表示 窗口 的 宽度 和 高 度 。 

e format: 窗口 的 像素 点 格式 。 取 值 见 PixelFormat 类 中 的 常量 定义 ， 一 般 取 值 
PixelFormat.RGBA 8888。 

e。 type: 窗口 的 显示 类 型 ， 常 用 的 显示 类 型 说 明 见 表 13-4。 


表 13-4 ”窗口 显示 类 型 的 取 值 说 明 














WindowManager 类 的 窗口 显示 类 型 说 明 
TYPE_SYSTEM_ALERT 系统 警告 提示 
TYPE_SYSTEM_ ERROR 系统 错误 提示 
TYPE_SYSTEM_OVERLAY 页 面 项 层 提示 
TYPE_SYSTEM_DIALOG 系统 对 话 框 
TYPE_STATUS BAR 状态 栏 
TYPE_TOAST 短暂 通知 Toast 





e flags: 窗口 的 行为 准则 ， 对 于 莫 浮 窗 来 说 ， 一 般 设置 为 FLAG_NOT_FOCUSABLE。 常 用 

的 窗口 标志 位 说 明 见 表 13-5。 

表 13-5 ”窗口 标志 位 的 取 值 说 阴 

说 明 
不 能 抢占 焦点 ， 即 不 接受 任何 按键 或 按钮 事件 
不 接受 触摸 屏 事 件 。 悬浮 窗 一 般 不 设置 该 标志 , 因为 一 旦 设置 该 标志 ， 
将 无 法 拖 动 悬浮 窗 
当 窗 口 允许 获得 焦点 时 〈 即 没有 设置 FLAG_ NOT_FOCUSALBE 标 
志 )， 仍 然 将 窗口 之 外 的 按键 事件 发 送 给 后 面 的 窗口 处 理 。 否 则 它 将 独 
占 所 有 的 按键 事件 ， 而 不 管 它们 是 不 是 发 生 在 窗口 范围 之 内 


WindowManager 类 的 窗口 标志 位 
FLAG_NOT_ FOCUSABLE 
FLAG_NOT_TOUCHABLE 


FLAG_NOT_TOUCH_MODAL 





FLAG LAYOUT_IN_SCREEN 允许 窗口 占 满 整 个 屏幕 





FLAG_LAYOUT_NO_LIMITS 
FLAG_WATCH OUTSIDE_TOUCH 


允许 窗口 扩展 到 屏幕 之 外 
如 果 设 置 了 FLAG_NOT_TOUCH_MODAL 标志 ， 则 当 按 键 动作 发 生 
在 窗口 之 外 时 ， 将 接收 到 一 个 MotionEvent.ACTION_OUTSIDE 事件 


自 定义 的 悬浮 窗 有 点 类 似 对 话 框 ， 它 们 都 是 独立 于 Activity 页 面 的 窗口 ,但 是 悬浮 窗 又 有 
- 些 与 众 不 同 的 特性 ， 例 如 : 

(1) 悬浮 窗 是 可 以 拖 动 的 ， 对 话 框 则 不 可 拖 动 。 

(2) 悬浮 窗 不 妨碍 用 户 触 摸 窗 外 的 区 域 ， 对 话 框 则 不 让 用 户 操作 框 外 的 控件 。 

(3) 悬浮 窗 独 立 于 Activity 页 面 ， 即 当 页 面 退出 后 ， 悬 浮 窗 仍 停留 在 屏幕 上 ， 而 对 话 杠 
与 Activity 页 面 是 共存 关系 ， 一 旦 页 面 退出 则 对 话 框 也 消失 了 。 

基于 悬浮 窗 的 以 上 特性 ， 若 要 实现 窗口 的 悬浮 效果 ， 就 不 仅仅 是 调用 WindowManager 的 
addView 方法 那么 简单 了 ， 而 是 需要 做 一 系列 的 自 定义 处 理 ， 具 体 步 又 如 下 : 
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CT01 在 AndroidManifest.xml 中 声明 系统 窗口 权限 ， 即 增加 下 面 这 句 : 








<uses-permission android:name="android.permission.SYSTEM ALERT WINDOW"/> 





C02 在 自 定义 的 悬浮 窗 控 件 中 ， 要 设置 触摸 监听 器 ， 并 根据 用 户 的 对 








窗口 位 置 ， 以 实现 悬浮 窗 的 拖 动 功能 。 

人 EX63 合理 设置 悬浮 窗 的 窗口 参数 ， 主 要 是 把 窗口 参数 的 
TYPE SYSTEM _ ALERT 或 者 TYPE _ SYSTEM ERROR ， 另 外 还 要 
FLAG_NOT_FOCUSABLE。 














F 势 滑动 来 相应 调整 


显示 类 型 设置 为 
设置 标志 位 为 


C04 在 构造 悬浮 窗 实例 时 ， 要 传 入 Application 的 上 下 文 Context， 这 是 为 了 保证 即使 退出 
Activity, 也 不 会 关闭 悬浮 窗 。 因 为 Application 对 象 在 App 运行 过 程 中 是 始终 存在 着 的 , 而 Activity 
对 象 只 在 打开 页 面 时 有 效 ， 一旦 退出 页 面 则 Activity 的 上 下 文 就 立刻 回收 (这 会 导致 依赖 于 该 上 下 


























文 的 悬浮 窗 也 一 块 被 回收 了 )。 
下 面 是 一 个 悬浮 窗 控 件 的 自 定义 代码 例子 : 
public class FloatWindow extends View { 
Private final static String TAG = "FloatWindow"; 
private Context mContext; / 声明 一 个 上 下 文 对 象 
private WindowManager wm; / 声明 一 个 窗口 管理 器 对 象 
private static WindowManager.LayoutParams wmParams; 
public View mContentView; / 声明 一 个 内 容 视图 对 象 
private float mScreenX, mScreenY; / 触摸 点 在 屏幕 上 的 横 纵 坐标 
private float mLastX, mLastY; / 上 次 触摸 点 的 横 纵 坐 标 
private float mDownX, mDownY， // 按 下 点 的 横 纵 坐标 
private boolean isShowing = false; / 是 否 正 在 显示 


public FloatWindow(Context context) { 
super(context); 
// 从 系统 服务 中 获取 窗口 管理 器 ， 后 续 将 通过 该 管理 器 添加 悬浮 窗 


wm=(WindowManager) contextgetSystemService(Context WINDOW_SERVICE); 


if (wmParams 一 nulD) { 
wmParams = new WindowManager.LayoutParams(); 
} 
mContext = context; 
! 


// 设置 悬浮 窗 的 内 容 布局 
public void setLayout(int layoutId) { 
/ 从 指定 资源 编号 的 布局 文件 中 获取 内 容 视 图 对 象 
mContentView=Layoutmflaterfrom(mContext).inflate(layoutId, null); 
/ 接管 悬浮 窗 的 触摸 事件 ， 使 之 即 可 随手 势 拖 动 ， 又 可 处 理 点 击 动作 
mContentView.setOnTouchListener(new OnTouchL istener() { 
/ 在 发 生 触 摸 事件 时 触发 
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public boolean onTouch(View v, MotionEvent event) { 
mScreenX = event.getRawX(O; 
mScreenY = event.getRawY(); 
switch (event.getAction()) { 
case MotionEvent.ACTION_DOWN: // 手指 按 下 
mDownX = mScreenX:; 
mDownY = mScreenY; 
break; 
case MotionEvent.ACTION_MOVE: // 手指 移动 
updateViewPosition0; / 更 新 视图 的 位 置 
break; 
case MotionEvent.ACTION_UP: // 手指 松 开 
updateViewPosition0; / 更 新 视图 的 位 置 
// 响应 悬浮 窗 的 点 击 事件 
if (Math.abs(mScreenX - mDownX) <3 
&& Math.abs(mScreenY - mDownY) <3) { 
if (mListener != null) { 
mListener.onFloatClick(v); 


} 

break:; 
mLastX = mScreenX:; 
mLastY = mScreenY; 
return true; 


/ 更 新 悬浮 窗 的 视图 位 置 
private void updateViewPosition() { 
/ 此 处 不 能 直接 转 为 整 型 ， 因 为 小 数 部 分 会 被 截 掉 ， 重 复 多 次 后 就 会 造成 偏 移 越 来 越 大 
wmParams.x = Math.round(wmParams.x + mScreenX - mLastX); 
wmParams.y = Math.round(wmParams.y + mScreenY - mLastY); 
// 通过 窗口 管理 器 更 新 内 容 视 图 的 布局 参数 
wm.update ViewLayout(mContentView, wmParams); 


} 


// 显示 悬浮 窗 
public void showO { 
if (mContentView != nulD) { 
// 设置 为 TYPE_SYSTEM_ALERT 类 型 ， 才 能 悬浮 在 其 他 页 面 之 上 
wmParams.type = WindowManagerLayoutParams.TYPE_ SYSTEM_ALERT' 
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wmParams.format = PixelFormat.RGBA 8888; 

wmParams.flags = WindowManager.LayoutParams.FLAG NOT FOCUSABLE; 
wmParams.alpha = 1.0f; // 1.0 为 完全 不 透明 ，0.0 为 完全 透明 

// 对 齐 方式 为 靠 左 且 靠 上 ， 因 此 悬浮 窗 的 初始 位 置 在 屏幕 的 左上 角 
wmParams.gravity = GravityLEFT | Gravity.TOP; 

wmParams.x = 0; 

wmParams.y = 0; 

/ 设置 悬浮 窗 的 宽度 和 高 度 为 自 适 应 

wmParams.width = WindowManager.LayoutParams.WRAP_CONTENT': 
wmParams.height = WindowManager.LayoutParams.WRAP_ CONTENT; 
// 添加 自 定义 的 窗口 布局 ， 然 后 屏幕 上 就 能 看 到 悬浮 窗 了 
wm.addView(mContentView, wmParams); 

isShowing = true; 


b 


// 关闭 悬浮 窗 
public void close() { 
if (mContentView != null) { 
// 移 除 自 定义 的 窗口 布局 
wm.removeView(mContentView); 
isShowing = false; 


// 判断 悬浮 窗 是 否 打开 
public boolean isShow() { 
return isShowing; 


} 


private FloatClickListener mListener; / 声明 一 个 悬浮 窗 的 点 击 监 听 器 对 象 


/ 设置 悬浮 窗 的 点 击 监 听 器 
public void setOnFloatListener(FloatClickListener listener) { 
mListener = listener; 


b 


// 定义 一 个 悬浮 窗 的 点 击 监听 器 接口 ， 用 于 触发 点 击 行为 
public interface FloatClickListener { 

void onFloatClick(View v); 
b 
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在 实际 开发 中 ， 悬 浮 窗 的 展示 内 容 是 变化 的 ， 毕 竟 一 个 内 容 不 变 的 悬浮 窗 对 用 户 来 说 没 
什么 用 处 。 具 体 的 应 用 例子 有 很 多 ， 比 如 说 时 钟 、 天 气 、 实 时 流量 、 股 市 指数 等 等 。 本 书 附录 
源码 给 出 了 实时 流量 与 股市 指数 两 个 动态 悬浮 窗 例子 ， 其 中 实时 流量 的 服务 代码 参见 media 
模块 的 TrafficServicejava， 股 市 指数 的 服务 代码 参见 media 模块 的 StockServicejava， 代 码 量 
较 多 就 不 在 书 中 贴 了 。 

对 于 悬浮 窗 来 说 ， 要 想 实 时 刷新 窗 体 内 容 ， 这 得 通过 服务 Service 来 实现 ， 所 以 动态 悬浮 
窗 要 在 Service 服务 中 创建 和 更 新 ， 页 面具 负责 启动 和 停止 服务 。 关 于 手机 的 实时 流量 ， 可 以 
通过 TrafficStats 类 的 相关 方法 计算 得 到 ， 有 具体 参见 第 6 章 的 “6.6.2 小 知识 : 应 用 包 管 理 
PackageManager”。 人 至 于 股市 指数 的 动态 展示 ， 可 以 通过 调用 财经 网 站 的 实时 指数 查询 接口 得 
到 , 比如 新 浪 财经 与 腾讯 财经 均 提 供 了 上 证 指数 与 深圳 成 指 的 查询 接口 , 接口 调用 方式 参考 第 
10 章 的 “10.2.4 HTTP 接口 调用 ” 

动态 悬浮 窗 的 演示 效果 如 图 13-26 到 图 13-29 所 示 ， 其 中 图 13-26 为 实时 流量 悬浮 窗 的 初 
始 界面 ， 此 时 流量 消耗 很 少 ; 图 13-27 为 打开 一 个 浏览 器 App 后 的 悬浮 窗 画 面 ， 此 时 流量 消 
耗 又 增 。 图 13-28 为 股市 指数 悬浮 窗 的 初始 界面 ， 此 时 刚 开 盘 一 片 惨 绿 ; 图 13-29 为 过 了 一 阵 
子 回 到 桌面 后 的 画面 ， 此 时 大 盘 终 于 翻 红 了 。 
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13-26 ”实时 流量 悬浮 窗 的 初始 界面 图 13-27 ”打开 浏览 器 后 的 悬浮 窗 画 面 
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图 13-28 ”股市 指数 悬浮 窗 的 初始 界面 图 13-29 大 盘 翻 红 之 后 的 悬浮 窗 画 面 


13.4.4 ”截图 和 录 屏 


显示 流量 悬浮 窗 关闭 流量 悬浮 窗 
显示 股指 悬浮 窗 关闭 股指 悬浮 窗 





: 3258.1967 -0.36%| 


际 证 成 指 : 11044.47 -0.06% 





显示 流量 悬浮 窗 关闭 流量 悬浮 窗 


11095.82 040% 


显示 股指 悬浮 窗 关闭 股指 悬浮 窗 








悬浮 窗 总 是 浮 在 其 他 页 面包 括 桌 面 之 上 ， 这 个 特性 非常 适用 于 一 些 屏幕 捕捉 的 场合 ， 比 
如 截图 和 录 屏 。Android5.0 之 后 开放 了 屏幕 捕捉 的 API， 因 此 开发 者 可 以 直接 调用 公开 方法 来 
截图 与 录 屏 ， 而 无 需 操 作 系统 底层 了 。 屏 幕 捕捉 的 功能 由 MediaProjectionManager 媒体 投影 管 
理 器 实现 ， 该 管理 器 的 对 象 从 系统 服务 MEDIA_PROJECTION_SERVICE 中 获得 。 注 意 
MediaProjectionManager 是 Android5.0 之 后 新 增 的 工具 类 ， 故 代码 中 要 补充 判断 系统 版 本 ， 如 
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果 是 4.* 及 以 下 版 本 ， 则 不 可 处 理 屏 幕 捕 捉 操 作 。 
具体 的 屏幕 捕捉 操作 ， 还 要 调用 媒体 投影 管理 器 对 象 的 getMediaProjection 方法 ， 获 取 
MediaProjection 媒体 投影 对 象 。MediaProjection 主要 有 两 个 方法 ， 说 明 如 下 。 


ecreateVirtualDisplay: 创建 虚拟 显示 层 。 可 分 别 指定 它 的 名 称 、 宽 高 、 密 度 、 标 志 、 泻 染 表 
面 等 。 其 中 标志 参数 通常 取 值 DisplayManager.VIRTUAL DISPLAY FLAG AUTO_ 
MIRROR， 泻 染 表面 则 按照 截图 和 录 屏 两 种 方式 分 别 取 值 。 

@ stop: 停止 投影 。 


屏幕 捕捉 的 用 途 主要 是 截图 和 录 屏 ， 这 有 点 像 摄像 头 的 功能 ， 截 图 对 应 拍照 ， 而 录 屏 对 
应 录像 。 对 于 拍照 和 录像 , 由 第 9 章 的 “9.1.2 使 用 Camera 拍 照 ?得 知 , 需要 创建 一 个 SurfaceView 
表面 视图 作为 画面 预览 层 , 就 屏幕 捕捉 而 言 ， 也 需 创建 一 个 虚拟 显示 对 象 作为 投影 预览 层 。 这 
个 投影 预览 层 即 前 面 createVirtualDisplay 方法 返回 的 VirtualDisplay 对 象 ， 具 体 的 表面 对 象 则 
为 createVirtualDisplay 方法 中 的 泻 染 表面 参数 ， 也 就 是 一 个 Surface 对 象 。 如 果 当 前 为 截图 操 
作 ， 则 调用 ImageReader 对 象 的 getSurface 方法 获得 演 染 表面 ， 如 果 当 前 为 录 屏 操作 ， 则 调用 
MediaCodec 对 象 的 createInputSurface 方法 获得 泻 染 表面 。 

上 面 提 到 截图 操作 会 用 到 ImageReader， 这 里 补充 说 明 一 下 该 类 的 几 个 常用 方法 。 


enewInstance: 静态 函数 ， 构 造 一 个 图 像 读 取 器 ， 可 指定 图 像 的 宽度 、 高 度 、 色 彩 模式 ， 以 
及 图 像 数 量 。 

ee getSurface: 获取 图 像 的 泻 染 表 面 。 在 实现 截图 功能 时 ， 这 里 的 表面 对 象 要 作为 

createVirtualDisplay 方法 的 输入 参数 。 

eacquireLatestImage: 获得 最 近 的 一 幅 图 像 数据 。 该 方法 返回 Image 对 象 ， 需 转 为 Bitmap 

格式 。 

与 截图 对 应 的 是 录 屏 ， 也 就 是 把 用 户 在 屏幕 上 的 操作 行为 录制 成 视频 。 因 为 视频 有 多 种 
格式 , 不 同 格式 的 编码 过 程 也 不 尽 相同 ， 所 以 录 屏 的 过 程 比 起 截图 要 复杂 得 多 , 主要 考虑 的 录 
屏 功 能 点 简 述 如 下 : 

(1) 需要 控制 何 时 开始 录 屏 ， 何 时 结束 录 屏 。 

(2) 设置 视频 的 编码 格式 及 其 对 应 的 编码 过 程 。 

(3) 指定 视频 的 常见 播放 参数 ， 如 尺寸 、 位 率 、 帧 率 、 色 彩 等 等 。 

具体 到 编码 实现 上 ， 录 屏 使 用 了 MediaCodec 媒体 编码 器 和 MediaMuxer 媒体 转换 器 两 个 
工具 ， 通 过 这 两 个 工具 的 相互 配合 ， 方 能 完成 屏幕 录制 功能 。 

下 面 是 媒体 编码 器 MediaCodec 的 主要 方法 说 明 。 

ecreateEncoderByType: 静态 函数 ， 根 据 编码 格式 构造 一 个 媒体 编码 器 。 编 码 格式 通常 取 值 

MediaFormat.MIMETYPE_VIDEO_AVC。 
econfigure: 设置 媒体 编码 的 参数 ， 包 括 视频 格式 、 视 频 宽 高 、 视 频 位 率 、 视 频 帧 率 等 。 
createInputSurface: 创建 一 个 用 于 输入 的 表面 对 象 。 在 实现 录 屏 功能 时 ， 这 里 的 表面 对 象 
要 作为 createVirtualDisplay 方法 的 输入 参数 。 
estart: 开始 给 媒体 编码 。 
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dequeueOutputBuffer: 给 输出 缓冲 区 排队 。 返 回 该 输出 缓冲 区 的 索引 位 置 。 
getOutputFormat: 获取 输出 格式 。 

getOutputBuffer: 根据 索引 位 置 获 取 输 出 缓冲 区 的 数据 。 
releaseOutputBuffer: 释放 指定 索引 位 置 的 输出 缓冲 区 。 

stop: 停止 给 媒体 编码 。 

release: 释放 媒体 编码 资源 。 


下 面 是 媒体 转换 器 MediaMuxer 的 主要 方法 说 明 。 


@ 构造 函数 : 根据 文件 路 径 与 文件 格式 构造 一 个 媒体 转换 器 。 文 件 格式 通常 取 值 
MediaMuxer.OutputFormat. MUXER_ OUTPUT MPEG 4. 

eaddTrack: 把 指定 格式 添加 到 转换 轨道 上 ， 并 返回 轨道 的 索引 位 置 。 

® start: 开始 媒体 转换 工作 。 

ewriteSampleData: 把 编码 转换 后 的 数据 写 入 索引 位 置 的 轨道 。 该 方法 需 在 MediaCodec 的 
getOutputBuffer 方法 之 后 调用 。 

estop: 停止 媒体 转换 工作 。 

@ release: 释放 媒体 转换 资源 。 


由 于 截图 和 录 屏 可 用 于 捕捉 其 他 App 的 画面 ， 为 了 让 录 屏 App 在 其 他 界面 上 也 能 响应 控 
制 行为 ， 因 此 要 把 录 屏 App 的 控制 条 做 成 悬浮 窗 的 样式 ， 通 过 悬浮 窗 的 内 部 按钮 来 控制 截图 
或 者 录 屏 操作 。 有 关 截 图 功能 (截取 屏幕 画面 ) 的 详细 源码 ， 参 见 本 书 附带 源码 里 面 media 
模块 的 ScreenCaptureActivity.java; 有 关 录 屏 功能 (录制 屏幕 操作 〉 的 详细 源码 ， 参 见 media 
模块 的 ScreenRecordActivity.java。 另 外 ， 利 用 悬浮 窗 观 看 视频 ， 能 够 随意 调整 视频 窗口 的 大 
小 与 位 置 ， 对 于 用 户 来 说 ， 这 比分 屏 和 画 中 画 模 式 更 加 方便 ， 有 兴趣 的 读者 可 实践 之 。 


13.5 “实战 项 目 : 影视 播放 器 一 一 爱 看 剧场 


众所周知 ， 在 移动 互联 网 的 手机 App 排行 榜 单 上 ， 用 户 量 最 大 的 门类 是 社交 App。 那 么 
排行 第 二 的 门类 是 什么 呢 ? 既 不 是 电 商 类 App， 也 不 是 浏览 器 App,， 更 不 是 新 闻 类 App, 排行 
老 二 的 竟然 是 以 腾讯 视频 、 爱 奇 艺 、 优 酷 、 乐 视 为 代表 的 视频 类 App。 想 想 也 挺 正常 ， 用 户 一 
个 人 彼 寞 空虚 的 时 候 , 没有 比 看 片 更 能 消磨 时 间 的 了 , 况且 人 民 的 生活 水 平 提高 了 , 也 不 差 钱 ， 
所 以 用 手机 看 片子 就 流行 开 了 。 既 然 视频 类 App 的 用 户 众 多 ， 如 何 让 用 户 拥有 良好 的 观 影 体 
验 , 这 便 是 个 值得 深入 探讨 的 课题 ， 本 实战 项 目 即 以 通行 的 影视 播放 器 为 蓝本 ,论述 “ 爱 看 剧 
场 ” 的 设计 与 实现 。 


13.5.1 设计 思 


要 说 看 电影 看 电视 ， 看 起 来 很 简单 ， 直 接 把 视频 放大 到 全 屏 好 了 。 可 是 手机 不 像 电 视 有 遥 
控 器 ， 遥 控 器 的 按键 足够 多 ， 进 行 任何 播放 控制 都 易如反掌 。 手 机 只 有 一 个 触摸 屏 ， 以 及 寥寥 
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几 个 按键 ， 远 远 无 法 满足 灵活 的 播 控 要 求 。 因 而 播放 界面 必须 提供 类 似 电脑 播放 器 下 方 的 控制 
条 ， 方 便 用 户 随 时 进行 播 控 操 作 。 例 如 爱 奇 艺 App 的 全 屏 播放 页 就 包含 视频 标题 、 进 度 条 、 
播放 按钮 、 播 放 时 长 等 控件 ， 如 图 13-30 所 示 。 





《 和 粉红 猪 小 妹 全 集 第 152 集 


图 13-30 爱 奇 艺 App 的 全 屏 播放 界面 


由 图 13-30 可 见 ， 当 前 正在 播放 的 视频 为 《粉红 猪 小 妹 》《〈 又 名 《小 猪 修 奇 》) ， 本 集 总 
时 长 为 五 分 零 一 秒 ， 当 前 已 经 播映 了 十 秒 。 但 播放 器 项 部 和 底部 的 控制 条 ， 并 不 会 一 直 显 示 在 
屏幕 上 ， 而 是 稍 等 片刻 即 自 动 消失 。 直 到 下 次 用 户 触摸 屏幕 之 时 ， 才 会 再 次 弹出 播放 控制 条 。 
基于 手机 播放 器 的 这 些 特性 ， 大 致 总 结 并 罗列 该 播放 器 必 不 可 少 的 技术 点 ， 有 具体 如 下 所 示 。 


(1) 视频 视图 VideoView: 承载 影视 画面 的 显示 区 域 。 

(2) 媒体 播放 器 MediaPlayer: 不 管 是 播放 音频 还 是 播放 视频 ， 都 要 用 到 媒体 播放 器 。 

(3) 视频 控制 条 VideoController: 系统 自 带 的 媒体 控制 条 不 好 用 ， 还 是 自 定义 的 控制 条 
更 好 使 。 

(4) 触摸 事件 MotionEvent: 除了 点 击 屏幕 弹出 控制 条 ， 还 能 通过 手势 拖 动 播放 进度 。 

(5) 补 间 动画 Animation: 在 控制 条 弹出 和 隐藏 的 时 候 ， 可 镭 加 平移 动画 与 灰 度 动画 ， 
看 起 来 更 加 自然 。 

(6) 按键 事件 KeyEvent: 用 户 按 下 手机 侧面 的 音量 加 减 键 ，App 要 自动 调节 媒体 类 型 的 
音量 。 

(7) 音 量 对 话 框 VolumeDialog: 用 户 也 可 通过 该 对 话 框 里 的 拖 动 条 将 音量 一 步调 节 到 位 。 


看 来 一 个 功能 完备 的 播放 器 App 真 不 简单 ， 仅 播放 界面 就 得 联合 运用 事件 、 动 画 、 多 媒 
体 这 三 章 的 主要 技术 ， 籍 此 正好 检阅 一 下 读者 对 这 三 章 的 学 习 成 果 。 
13.5.2 ”小 知识 : 坚 屏 与 横 屏 切换 


由 前 面 的 小 节 “13.4.1 分 屏 一 一 多 窗口 模式 ”可 知 ， 假 定 视 频 App 处 于 播放 过 程 当中 ， 
若 要 在 分 屏 和 全 屏 切换 之 时 保持 视频 页 的 内 容 ， 则 需 在 该 页 面 的 activity 节点 加 上 如 下 属性 描 
述 : 


android:configChanges="screenLayoutlorientation" 


628 | Android Studio 开发 实战 : 从 零 基础 到 App 上 线 (第 2 版 ) 


添加 属性 之 后 ， 分 屏 和 全 屏 的 切换 问题 解决 了 ， 然 而 要 是 调转 屏幕 方向 ， 将 屏幕 在 竖 屏 
与 横 屏 之 间 切 换 ， 则 视频 页 仍然 遭 到 重 置 ， 无 法 自动 继续 播放 。 这 是 因为 标志 位 screenLayout 
仅 作 用 于 分 屏 / 全 屏 切 换 的 情况 ， 要 想 让 竖 屏 / 横 屏 切换 的 情况 也 能 为 生命 周期 过 程 所 峪 免 ， 还 
需 增加 设置 标志 位 screenSize， 也 就 是 说 以 下 的 属性 描述 才 对 竖 屏 / 横 屏 切换 奏效 : 


android:configChanges="screenSizelorientation" 


当然 ， 手 机 屏幕 的 状态 变化 并 不 限于 分 屏 /全 屏 切 换 、 竖 屏 / 横 屏 切换 这 两 种 情况 ， 还 有 输 
入 法 键盘 弹出 /关闭 等 情况 。 之 所 以 要 给 activity 节点 增加 属性 android:configChanges， 并 设置 
合适 的 属性 值 避 免 页 面 重 置 ， 是 因为 默认 情况 下 ，App 每 次 切换 屏幕 都 会 重启 Activity， 即 先 
执行 活动 页 面 的 onDestroy 方法 ， 再 执行 活动 页 面 的 onCreate 方法 ， 这 便 导 致 正在 播放 的 视频 
被 中 断 返 回 了 。 新 增 属性 configChanges 的 意思 是 ， 在 某 些 情况 之 下 ， 屏 幕 变更 不 用 重启 活动 
页 面 ， 只 需 调 用 onConfigurationChanged 方法 重新 设 定 显示 方式 ; 故而 只 要 给 该 属性 指定 若干 
蔬 免 情况 ， 就 能 避免 无 谓 的 页 面 重启 操作 了 。 屏 幕 变更 夫 免 情况 的 取 值 说 明 见 表 13-6。 

表 13-6 ”屏幕 变更 豁免 情况 的 取 值 说 明 




















configChanges 属性 的 取 值 说 明 

touchscreen 触摸 屏 发 生 改变 ， 一 般 不 会 发 生 

keyboard 键盘 发 生 改变 ， 例 如 使 用 了 外 部 键盘 

keyboardHidden 软 键盘 弹出 或 隐藏 

navigation 导航 发 生 改变 ， 一 般 不 会 发 生 

ScreenLayout 屏幕 的 显示 发 生 改变 ， 例 如 使 用 了 外 部 显示 器 ， 或 者 在 全 屏 和 分 屏 
之 间 切 换 

fontScale 字体 比例 发 生 改 变 ， 例 如 在 系统 设置 中 调整 默认 字体 

orientation 屏幕 方向 发 生 改变 

screenSize 屏幕 大 小 发 生 改变 ， 比 如 在 竖 屏 与 横 屏 之 间 切 换 


另外 要 新 增 screenOrientation 属性 ， 表 明 该 页 面 允 许 哪 种 形式 的 屏幕 方向 ， 对 于 视频 播放 
页 面 来 说 ， 该 属性 值 要 设置 为 sensor 表示 由 传感器 控制 。 屏 幕 方向 的 取 值 说 明 见 表 13-7。 


表 13-7 屏幕 方向 的 取 值 说 明 




















screenOrientation 属性 的 取 值 说 明 

portrait 只 允许 垂直 方向 

landscape 只 允许 水 平方 向 

sensor 由 传感器 控制 方向 

unspecified 默认 值 ， 由 系统 选择 方向 

User 使 用 用 户 当前 首选 的 方向 

fullSensor 显示 的 4 个 方向 由 传感器 决定 ， 即 4 个 方向 都 允许 倒转 


为 了 验证 上 述 的 屏幕 其 免 属性 是 否 奏 效 ， 下 面 给 出 一 个 演示 页 面 ， 该 页 面 已 对 activity 节 
点 声明 蔬 免 了 竖 屏 / 横 屏 切换 〈screenSize) ， 具 体 的 节点 配置 如 下 : 
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<activity 
android:name=".OrientationActivity" 
android:configChanges="orientation|keyboardHiddenlscreenSize" 
android:screenOrientation="sensor" /> 
然后 编写 演示 页 面 代码 ， 主 要 是 重 写 了 onConfigurationChanged 方法 ， 在 该 方法 中 打印 屏 
幕 切换 的 日 志 ， 详 细 的 页 面 代 码 如 下 所 示 : 
public class OrientationActivity extends AppCompatActivity { 


private TextView tv_orientation; 
private String mDesc = ""; 








protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_orientation); 
TextView tv_create = findViewById(R.id.tv_create); 
tv_orientation = findViewById(R.id.tv_orientation); 
String desc = String.format("%s %s", DateUtil.getNowTime(), "请 旋转 手机 屏幕 "); 
tv_create.setText(desc); 


} 


// 在 配置 项 变更 时 触发 。 比 如 屏幕 方向 发 生变 更 等 等 
public void onConfigurationChanged(Configuration newConfig) { 
super.onConfigurationChanged(newConfig); 
switch (newConfig.orientation) { / 判断 当前 的 屏幕 方向 
case Configuration.ORIENTATION_PORTRAIT: / 切换 到 竖 屏 
mDesc = String.format("%s\n%s %s", mDesc, 
DateUtil.getNowTime(), "当前 屏幕 为 竖 屏 方向 "); 
tv_orientation.setText(mDesc); 
break; 
case Configuration.ORIENTATION_LANDSCAPE: // 切换 到 横 屏 
mDesc = String.format("%s\n%s %s", mDesc, 
DateUtil.getNowTime(), "当前 屏幕 为 横 屏 方向 "); 
break; 
default: 
break; 


} 

启动 测试 App 后 ， 进 入 演示 页 面 并 旋转 屏幕 ， 页 面 上 的 旋转 日 志 如 图 13-31 和 图 13-32 
所 示 。 其 中 图 13-31 为 刚 打 开演 示 页 面 时 的 初始 画面 ， 此 时 手机 处 于 竖 屏 位 置 接着 旋转 手机 
使 之 处 于 横 屏 位 置 ， 此 时 的 屏幕 日 志 如 图 13-32 所 示 ， 可 见 随 着 屏幕 方向 变更 ， 只 有 
onConfigurationChanged 方法 得 到 调用 ， 而 onCreate 方法 并 未 再 次 调用 。 
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12:58:12 活动 页 面 已 创建 ， 请 旋转 手机 屏幕 12:58:12 活动 页 面 已 创建 ， 请 旋转 手机 屏幕 
12:58:17 当前 屏幕 为 横 屏 方向 12:58:17 当前 屏幕 为 横 屏 方 向 
12:58:28 当前 屏幕 为 坚 屏 方向 
图 13-31 竖 屏 时 的 演示 界面 图 13-32 切 到 横 屏 的 演示 界面 


13.5.3 ”代码 示例 


(1) 如 果 把 动画 描述 定义 在 XML 文件 中 ， 注 意 动 画 定 义 文件 要 放 在 res/anim 目录 下 。 
(2) 打开 影视 文件 ， 要 记得 往 AndroidManifestxml 添加 SD 卡 的 权限 配置 : 
<!--SD 卡 -> 
<uses-permission android:name="android.permission. WRITE EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.MOUNT UNMOUNT FILESYSTEMS"/> 


(3) 修改 values\styles.xml 样式 定义 文件 ， 补 充 下 列 的 主题 风格 配置 ,完成 全 屏风 格 的 三 
项 设置 (属性 android:windowFullscreen 表示 是 否 隐 藏 系统 状态 栏 , 属性 android:windowNoTitle 
表示 是 否 去 除 App 的 导航 栏 ， 属 性 android:windowContentOverlay 表示 是 否 清 除 窗 体 背 景 ) : 


<!-- 定义 了 一 个 全 屏风 格 -> 
<style name="FullScreenTheme" parent="AppCompatTheme"> 





<item name="android:windowNoTitle">true</item> 

<item name="android:windowFullscreen">true</item> 

<item name="android:windowContentOverlay">(@null</item> 
</style> 


(4) 给 视频 播放 页 面 的 activity 节点 添加 configChanges 属性 用 于 设置 屏幕 容 免 情况 ， 添 
加 theme 属性 用 于 设置 全 屏风 格 ， 添 加 supportsPictureInPicture 属性 用 于 支持 画 中 画 模式 ， 完 
整 的 activity 节点 配置 参考 如 下 : 


<!-- 视频 播放 页 面 要 同时 豁免 分 屏 /全 屏 、 竖 屏 / 横 屏 这 两 种 屏幕 切换 情况 --> 
<activity 
android:name=".MovieDetailActivity" 
android:configChanges="orientation|keyboardHidden|screenSizelscreenLayout" 
android:screenOrientation="sensor" 
android:theme="(@style/FullScreenTheme" 
android:supportsPictureInPicture="true" /> 


(5) 要 在 真 机 上 测试 实战 项 目 ， 以 验证 屏幕 在 分 屏 / 全 屏 切换 、 竖 屏 / 横 屏 切换 之 时 ， 是 


否 都 能 自动 继续 播放 视频 。 
(6) 对 于 Android 8.0 及 以 上 系统 ， 为 了 营造 视频 不 间断 播放 的 效果 ， 可 考虑 在 按 下 主页 
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键 时 自动 开启 画 中 画 模式 ， 这 样 即使 返回 手机 桌面 ， 用 户 依然 能 够 继续 观看 视频 。 其 中 监听 
Home 按键 的 办 法 ， 可 参考 本 书 附带 源码 event 模块 的 KeyHardActivity.java。 


从 前 两 节 介绍 的 VideoView 视频 视图 的 集成 效果 来 看 ， 它 与 主流 的 影视 播放 器 相 比 ， 还 
欠缺 了 许多 高 级 的 播放 功能 ， 包 括 但 不 限于 : 


(1) 播放 器 的 视频 画面 不 会 自动 全 屏 显 示 。 

(2) 播放 器 无 法 控制 调 大 和 调 小 音量 。 

(3) 播放 器 不 会 自动 设置 标题 和 背景 。 

基于 以 上 的 不 足 之 处 ， 要 想 让 视频 播放 画面 生动 活泼 起 来 ， 势 必要 重新 写 一 个 既 好 看 又 
好 用 的 播放 器 控件 。 初 步 评 估 要 对 视频 视图 VideoView 进行 重 写 ， 经 过 进一步 的 查看 源码 与 
深入 分 析 ， 发 现 影视 播放 器 的 改造 内 容 ,主要 是 对 视频 画面 做 功能 方面 的 增强 ,所 以 影视 播放 
界面 的 改造 方案 基本 确定 为 : 由 视频 视图 VideoView 派生 出 一 个 电影 视图 MovieView， 并 提 
供 以 下 新 增 功能 : 


臣 写 尺寸 测量 方法 onMeasure， 实 现 自动 全 屏 。 
E 写 触摸 事件 监听 方法 onTouch， 用 于 弹出 或 关闭 视频 控制 条 。 

(3) 重 写 按键 事件 监听 方法 onKeyDown， 用 于 调节 音量 的 大 小 。 

(4) 补充 新 方法 用 于 设置 标题 和 背景 。 

(5) 自动 查找 存储 卡 上 已 有 的 视频 文件 ， 并 以 列表 形式 展示 。 

按照 上 述 的 改造 方案 编码 实现 , 播放 器 会 先 打开 一 个 影视 列表 页 面 如 图 13-33 所 示 , 列表 
显示 的 是 手机 上 找到 的 视频 文件 , 左边 为 视频 名 称 右边 为 播放 时 长 ,当然 用 户 也 可 点 击 上 方 的 
“打开 文件 ”按钮 手工 选择 影视 来 源 。 























Ss IMG_3842 


> <unknown> 
疆 - 一 前 检 





图 13-33 ”影视 播放 的 视频 列表 


然后 点 击 列表 中 的 某 个 影视 文件 ， 比 如 《海洋 世界 》， 紧 接着 跳 转 到 全 屏 显示 的 播放 器 
界面 ， 最 终 的 影视 播放 器 效果 如 图 13-34 到 图 13-37 所 示 。 其 中 图 13-34 为 打开 视频 开始 播放 
的 画面 ， 此 时 视频 上 部 展示 标题 栏 ， 下 部 展示 控制 条 ; 播放 过 程 中 不 做 任何 操作 ， 则 标题 栏 与 
控制 条 等 待 5 秒 后 会 自动 隐藏 ， 如 图 13-35 所 示 。 
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图 13-34 爱 看 剧场 开始 播放 图 13-35 爱 看 剧场 正在 播放 
如 果 需 要 调节 音量 大 小 ， 则 按 下 手机 侧面 的 加 减 按钮 ， 屏 幕 中 央 会 自动 弹出 音量 对 话 框 ， 
如 图 13-36 所 示 ， 音 量 对 话 框 的 实现 过 程 参 见 第 11 章 。 视 频 播放 结束 ， 则 显示 播放 器 的 默认 
背景 ， 如 图 13-37 所 示 。 











图 13-36 爱 看 剧场 调节 音量 


在 影视 播放 过 程 中 , 按 下 主页 键 回 到 手机 桌面 ， 则 播 
放 器 自动 进入 画 中 画 模式 , 也 就 是 缩小 成 屏幕 右 下 角 的 悬 
浮 窗 口 ， 如 图 13-38 所 示 。 

经 过 一 番 的 改造 折腾 , 这 个 影视 播放 器 总 算 满 足 了 大 
部 分 的 日 常 播放 要 求 , 而 这 也 是 主流 视频 播放 器 必 备 的 播 
放 功能 。 怎 么 样 ， 是 不 是 颇 有 成 就 感 呢 ? 该 播放 器 作为 阶 
段 性 的 实战 项 目 ， 也 给 取 个 大 名 叫 “ 爱 看 剧场 ”好 了 。 

下 面 是 电影 视图 MovieView 部 分 新 增 功能 的 代码 片 ee 
段 例子 ， 更 多 源码 参见 本 书 附带 源码 media 模块 的 “图 13-38 影视 播放 器 开启 西 中 西 模式 
MoviePlayerActivity.java 、 MovieDetailActivity.java 和 和 














MovieView.java。 


// 重 写 onMeasure 方法 的 目的 是 :自动 将 电影 视图 扩大 至 全 屏 显示 
protected void on Measure(int widthMeasureSpec, int heightMeasureSpec) { 
// realWidth 和 realHeight 是 MediaPlayer 的 宽度 和 高 度 
int width = getDefaultSize(real Width, width MeasureSpec); 
int height = getDefaultSize(realHeight, heightMeasureSpec); 
if (realWidth > 0 && realHeight > 0) { 
if (real Width * height > width * realHeight) { 
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height = width * realHeight / real Width; 
} else if (realWidth * height < width * realHeight) { 
width = height * realWidth / real Height; 
b; 
} 
/ 重新 设置 视图 的 宽度 和 高 度 
setMeasuredDimension(width, height); 


lb 


private int mXpos, mYpos; / 手指 按 下 时 的 横 纵 坐标 
private int mOffset;// 判定 为 点 击 动作 的 偏 移 区 间 


// 接管 触摸 事件 ， 判 断 是 否 需 要 弹出 顶部 和 底部 的 控制 条 
public boolean onTouch(View v, MotionEvent event) { 
Switch (event.getAction()) { 
case MotionEvent.ACTION_DOWN: // 手指 按 下 
mXpos = (int) event.getX(); 
mYpos = (int) event.getY(); 
break; 
case MotionEvent.ACTION_UP: // 手指 松 开 
// 松 开 手指 ， 则 弹出 或 关闭 相关 的 控件 〈 如 顶部 的 标题 栏 和 底部 的 控制 条 ) 
if (Math.abs(event.getX() - mXpos) < mOffset && 
Math.abs(event.getY() - mYpos) < mOffset) { 
showOrHide0; / 显示 或 者 隐藏 顶部 与 底部 视图 
break:; 
default: 
break; 
} 
return true; 


y 


// 在 发 生 按键 事件 时 触发 ， 方 便 音 量 对 话 框 调节 音量 大 小 
public boolean onKey(View v, int keyCode, KeyEvent event) { 
让 (keyCode 一 KeyEvent. KEYCODE_VOLUME _UP) { // 按 下 了 音量 + 键 
// 显示 音量 对 话 框 ， 并 将 音量 调 大 一 级 
showVolumeDialog(AudioManagerADJUST_RAISE); 
Teturn true; 
} elseif (keyCode 一 KeyEventKEYCODE VOLUME DOWN) { // 按 下 了 音量 - 键 
// 显示 音量 对 话 框 ， 并 将 音量 调 小 一 级 
showVolumeDialog(AudioManager. ADJUST_ LOWER); 
return true; 
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return false; 


13.6 ”实战 项 目 : 音乐 播放 器 一 一 浪花 音乐 


又 到 每 章 结 尾 的 实战 项 目 时 间 了 。 手 机 上 的 多 媒体 内 容 讲 究 声 情 并 茂 、 悦 目 且 悦耳 ， 这 
样 才能 让 用 户 的 感官 得 到 最 大 享受 。 影视 播 放 器 由 于 存在 视频 自身 的 画面 , 反而 限制 了 开发 者 
的 施展 空间 ; 而 音乐 播放 器 允许 定制 播放 画面 ， 开发 者 有 足够 空间 施展 拳脚 。 本 节 以 “音乐 播 
放 器 浪花 音乐 ”为 实战 项 目 ， 通 过 该 项 目的 编码 练习 巩固 和 提高 开发 者 的 实战 技能 。 


13.6.1 设计 思路 








大 家 常见 的 主流 音乐 播放 器 (如 QQ 音乐 、 酷 狗 音乐 、 酷 我 音乐 、 网 易 云 音 乐 、 虾 米 音乐 
百度 音乐 等 ) 不 外 乎 有 3 项 播放 功能 : 

(1) 展示 音乐 和 歌曲 列表 。 

(2) 在 歌曲 详情 页 面 滚动 展示 歌词 ， 并 高 亮 显示 当前 正在 播放 的 歌词 片段 。 

(3) 通过 音乐 控制 条 显示 播放 进度 ， 并 提供 开始 与 暂停 、 拖 动 播放 的 功能 。 

只 看 文字 描述 有 点 抽象 ， 还 是 先 给 出 播放 器 的 效果 图 ， 方 便 查找 对 应 的 功能 。 如 图 13-39 
所 示 为 播放 器 的 歌曲 列表 页 面 ， 点 击 项 部 的 “打开 音乐 文件 ”会 弹出 文件 对 话 框 ， 用 于 选择 音 
频 文件 ， 底 部 是 播放 器 的 控制 条 ， 中 间 为 当前 手机 上 的 所 有 音乐 文件 列表 。 点 击 某 个 音乐 项 ， 
进入 该 音乐 的 详情 页 面 ， 如 图 13-40 所 示 。 页 面 项 部 显示 歌曲 名 称 和 演唱 者 ， 页 面 底部 是 播放 
器 控制 条 ， 页 面 中 间 为 该 歌曲 对 应 的 歌词 内 容 。 























图 13-39 播放 器 的 歌曲 列表 页 面 13-40 ”播放 器 的 歌曲 详情 页 面 
接 下 来 对 音乐 播放 器 的 3 项 功能 进行 详细 剖析 。 
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对 于 第 一 点 的 展示 歌曲 列表 ， 让 用 户 手动 添加 不 但 费时 费力 ， 而 且 用 户 往往 搞 不 清楚 手 
机 上 的 歌曲 都 放 在 哪个 目录 。 我 们 假设 用 户 是 “ 傻 白 甜 ”， 开 发 者 做 的 App 就 得 智能 贴心 ， 
主动 帮 用 户 把 手机 上 的 歌曲 找 出 来 。 要 想 实现 这 个 功能 , 可 以 通过 内 容 组 件 访问 系统 自 带 的 媒 
体 库 ， 查 找 并 显示 媒体 库 中 的 歌曲 列表 。 

对 于 第 二 点 的 深 动 歌词 显示 ， 常 见 的 歌词 文件 是 LRC 格式 的 文本 文件 ， 内 容 主要 是 每 名 
歌词 的 文字 与 开始 时 间 。 文 本 文件 的 解析 并 不 复杂 ， 难 点 主要 是 滚动 显示 。 乍 看 歌词 从 下 往 上 
滚动 ， 适 合 采用 平移 动画 ， 然 而 歌词 滚动 不 是 匀速 的 ， 因 为 每 句 歌 词 的 间隔 时 间 并 不 固定 ， 只 
能 把 整个 歌词 滚动 分 解 为 若干 动画 ， 有 多 少 行 就 有 多 少 个 动画 。 

对 于 第 三 点 的 音乐 控制 条 ， 总 体 上 使 用 前 面 提 到 的 视频 控制 条 。 不 过 音乐 控制 条 更 加 复 
杂 ， 因 为 除了 控制 音频 的 播放 ， 还 要 控制 歌词 动画 的 播放 。 另 外 ,音乐 控制 条 显示 在 歌曲 列表 
页 面 上 ， 为 了 与 主流 播放 器 看 齐 ， 最 好 在 系统 通知 栏 固定 放置 音乐 控制 条 。 

弄 懂 了 音乐 播放 器 的 主要 功能 ， 再 来 看 该 播放 器 用 到 的 App 开发 技术 。 读 者 能 从 第 1 章 
一 直 看 到 本 章 ， 学 习 的 耐心 真是 很 好 。 如 果 用 到 前 面 章 节 的 知识 点 ， 这 里 就 一 起 列举 出 来 。 笔 
者 先 抛砖引玉 ， 读 者 发 现 遗 漏 的 地 方 可 加 以 补充 。 


(1) 服务 Service: 歌曲 播放 不 依赖 于 某 个 页 面 , 即使 用 户 回 到 桌面 ,歌曲 也 要 继续 播放 ， 
因此 必须 在 后 台 服 务 中 播放 歌曲 。 

(2) 应 用 Application: 正在 播放 的 歌曲 名 称 ， 在 播放 器 的 任何 页 面 都 能 看 到 ， 用 到 了 全 
局 内 存 ， 要 把 歌曲 名 称 保存 在 自 定义 的 Application 类 中 。 

(3) 内 容 解析 器 ContentResolver: 系统 媒体 库 中 的 音频 文件 ， 需 要 通过 内 容 解析 器 访问 
媒体 库 的 音频 资源 ， 详 细 路 径 是 MediaStore.Audio.Media.EXTERNAL_CONTENT_URI。 

(4) 文件 存 取 : 歌词 文件 与 音乐 文件 在 同一 个 目录 下 , 文件 名 一 样 , 只 是 扩展 名 变 为 lrc。 

(5) 通知 Notification: 系统 通知 栏 要 显示 音乐 控制 条 ， 就 得 把 后 台 服 务 以 通知 的 形式 在 
前 台 运 行 。 

(6) 媒体 播放 器 MediaPlayer: 播放 音频 文件 ， 自 然 会 用 到 媒体 播放 器 。 

(7) 音频 控制 条 AudioController: 跟 影视 播放 器 一 样 ， 自 定义 样式 的 控制 条 更 能 满足 个 
性 化 的 定制 要 求 。 

(8) 按键 事件 KeyEvent 与 音量 对 话 框 VolumeDialog: 用 户 按 手机 侧面 的 加 、 减 键 ， 播 
放 器 应 弹出 音量 调节 对 话 框 ， 供 用 户 调整 音量 大 小 。 

(9) 动画 Animation: 歌词 的 滚动 显示 ， 可 使 用 平移 动画 ， 也 可 使 用 属性 动画 实现 歌词 
滚动 效果 。 

(10) 其 余 高 级 控件 : 如 列表 视图 ListView、 进 度 条 ProgressBar、 拖 动 条 SeekBar 等 ， 
有 待 读者 进一步 发 掘 。 

不 看 不 知道 ， 一 看 吓 一 跳 。 如 果 仅 播放 声音 ， 技 术 上 只 要 Activity 加 MediaPlayer 就 行 ， 
最 多 再 加 一 个 媒体 控制 条 MediaController， 三 板斧 够 用 了 。 但 是 要 让 播放 器 变 得 生动 活泼 ,要 
让 用 户 真正 去 欣赏 音乐 ,开发 者 要 做 的 工作 就 不 是 实现 基础 功能 , 而 是 从 界面 设计 到 用 户 体验 ， 
每 个 细节 都 要 充分 考虑 ， 所 以 实际 运用 的 技术 远 远 不 止 三 板斧 。 
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13.6.2 ”小 知识 : 可 变 字符 串 SpannableString 


大 家 都 知道 ， 文 本 控件 家 族 显示 文本 内 容 使 用 setText 方法 ， 使 用 setTextColor 方法 设置 
文本 颜色 , 使 用 setTextSize 方法 设置 文本 大 小 , 使 用 setTextAppearance 方法 设置 文本 样式 ( 包 
括 颜 色 、 大 小 、 风 格 等 ) 。 普 通 的 用 法 只 能 对 控件 的 所 有 文本 做 统一 设置 ， 如 果 想 对 前 一 段 文 
本 加 大 加 粗 ， 对 中 间 一 段 文本 显示 红色 ， 再 将 后 面 一 段 文本 换 成 图 像 ， 就 无 能 为 力 了 。 为 了 解 
决 分 段 文 本 使 用 不 同样 式 的 需求 ，Android 提供 了 可 变 字符 串 SpannableString， 通 过 该 工具 实 
现 对 文本 分 段 显示 。 

SpannableString 的 原理 是 给 指定 位 置 的 文本 赋予 对 应 的 样式 , 从 而 告知 系统 这 段 文本 的 显 
示 方 式 。 具 体 到 编码 有 3 个 步 又， 说明 如 下 : 


人 ER) 从 指定 文本 字符 串 构造 一 个 SpannableString 对 象 。 
本 02 调用 SpannableString 对 象 的 setSpan 方法 设置 指定 文本 段 的 显示 风格 。 该 方法 的 第 一 
个 参数 为 风格 样式 对 象 ， 第 二 个 参数 为 文本 段 的 起 始 位 置 ， 第 3 个 参数 为 文本 段 的 终止 位 置 ， 第 4 
个 参数 为 风格 的 范围 标志 ,， 用 来 标识 在 文本 段 前 后 输入 新 字符 时 是 否 令 它 们 应 用 这 个 风格 (主要 对 
EditText 起 作用 ) 。 风 格 范围 标志 的 取 值 说 明 见 表 13-8。 
人 3 调用 文本 控件 对 象 的 setText 方法 设置 定义 好 的 SpannableString 对 象 。 
表 13-8 风格 范围 标志 的 取 值 说 明 
说 明 
前 后 都 不 包括 
前 面包 括 ， 后 面 不 包括 
前 面 不 包括 ， 后 面包 括 
前 后 都 包括 
显示 风格 的 定义 在 android.text.style 包 中 ， 总 共有 30 多 个 。 当 然 , 常用 的 没 这 么 多 , 笔者 
整理 了 8 个 常用 的 显示 风格 ， 详 见 表 13-9。 
表 13-9 ”常用 的 显示 风格 类 列表 






































Spanned 类 的 范围 标志 
SPAN_EXCLUSIVE EXCLUSIVE 
SPAN_INCLUSIVE_EXCLUSIVE 
SPAN_EXCLUSIVE_INCLUSIVE 
SPAN_INCLUSIVE_INCLUSIVE 





























可 变 字符 串 的 显示 风格 类 | 说 明 

RelativeSizeSpan 设置 文字 大 小 。1.0 表示 正常 大 小 ，0.5 表示 缩小 到 原来 的 一 半 ，2.0 表示 放大 
到 原来 的 两 倍 

StyleSpan 设置 文字 字体 。 字 体 风 格 的 取 值 说 明 见 表 13-10 

ForegroundColorSpan 设置 文字 的 颜色 

BackgroundColorSpan 设置 文字 的 背景 色 

UnderlineSpan 给 文字 加 下 划 线 

StrikethroughSpan 给 文字 加 删除 线 

ImageSpan 把 文字 替换 为 图 片 

URLSpan 给 文字 添加 超 链接 
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表 13-10 ”字体 风格 的 取 值 说 明 











Typeface 类 的 字体 风格 说 明 

NORMAL 正常 字体 
BOLD 加 粗 字体 
ITALIC 倾斜 字体 





BOLD ITALIC 既 加 粗 又 设置 为 斜体 





下 面 是 使 用 SpannableString 设置 文字 样式 的 代码 : 


public class SpannableActivity extends AppCompatActivity { 
private TextView tv_spannable; / 声明 一 个 用 于 展示 可 变 字符 串 的 文本 视图 对 象 
private String mText= "为 人 民 服 务 "; / 原始 字符 串 
private String mKey =" 人 民 "; // 关键 字 
private int mBeginPos, mEndPos; / 起 始 位 置 和 结束 位 置 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_spannable); 
tv_spannable = findViewById(R.id.tv_spannable); 
tv_spannable.setText(mText); 
mBeginPos = mText.indexOftmKey); 
mEndPos = mBeginPos + mKey.length(); 
initSpannableSpinner(); 

b 


// 初始 化 可 变样 式 的 下 拉 框 
private void initSpannableSpinner() { 
ArrayAdapter<String> spannableAdapter = new ArrayAdapter<String>(this, 
R.layout.item _select, spannableArray); 
Spinner sp_spannable = findViewById(R.id.sp_spannable); 
sp_spannable.setPrompt(" 请 选择 可 变 字符 串 样 式 "); 
sp_spannable.setAdapter(spannableA dapter); 
sp_spannable.setOnItemSelectedListener(new SpannableSelectedListener()); 
sp_spannable.setSelection(0); 
private String[] spannableArray = { 
" 增 大 字号 ", "加 粗 字体 ", "前 景 红色 ", "背景 绿色 ", "下 划 线 ", "表情 图 片 " }; 
class SpannableSelectedListener implements OnItemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
// 创建 一 个 可 变 字符 串 
SpannableString spanText = new SpannableString(mText); 
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让 (arg2 一 0){ // 增 大 字号 
spanText.setSpan(new RelativeSizeSpan(1.5f), mBeginPos, mEndPos, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
}else if (arg2 一 1) { // 加 粗 字 体 
spanText.setSpan(new StyleSpan( Typeface.BOLD), mBeginPos, mEndPos, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
} else if(arg2 ==2){ // 前 景 红色 
spanText.setSpan(new ForegroundColorSpan(Color.RED), mBeginPos, 
mEndPos, Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
} else if(arg2 一 3){ // 背景 绿色 
spanText.setSpan(new BackgroundColorSpan(Color.GREEN), mBeginPos, 
mEndPos, Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
} else if(arg2 一 4){ // 下 划 线 
spanText.setSpan(new UnderlineSpan(), mBeginPos, mEndPos, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
} else if(arg2 一 5) { / 表情 图 片 
spanText.setSpan(new ImageSpan(SpannableActivity.this, R.drawable.people), 
mBeginPos, mEndPos, Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
} 
tv_spannable.setText(spanText); 
} 
public void onNothingSelected(AdapterView<?> arg0) {} 


} 


SpannableString 的 不 同 风格 效果 如 图 13-41 一 图 13-46 所 示 。 其 中 ， 如 图 13-41 所 示 为 加 
大 字体 后 的 效果 ， 如 图 13-42 所 示 为 加 粗 字 体 后 的 效果 ， 如 图 13-43 所 示 为 修改 文字 颜色 后 的 
效果 ， 如 图 13-44 所 示 为 修改 文字 背景 后 的 效果 ， 如 图 13-45 所 示 为 增加 下 划 线 后 的 效果 ， 如 
图 13-46 所 示 为 把 文字 蔡 换 成 图 片 后 的 效果 。 


可 变 字符 串 样式 : 增 大 字号 = 可 变 字符 串 样式 : 加 粗 字体 





为 人 民 服 务 为 人 民 服务 


图 13-41 增 大 字体 的 风格 图 13-42 ”加 粗 字体 的 风格 





可 变 字符 串 样式 : 前 景 红色 可 变 字符 串 样 式 : 背景 绿色 
为 人 民 服务 为 网 民 服 务 





图 13-43 ”修改 文字 颜色 的 风格 图 13-44 ”修改 文字 背景 色 的 风格 
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可 变 字符 串 样式 : 下 划 线 可 变 字符 串 样 式 : 表情 图 片 


为 人 民 服 务 PN 
为 人 民 服 » 直 ns 


图 13-45 添加 下 划 线 的 风格 图 13-46 图 片 蔡 换 文字 的 风格 


读者 是 否 对 图 13-46 似曾相识 ? 使 用 QQ 聊天 时 会 自动 把 特定 字符 转 成 表情 图 片 , 比如 把 
文字 内 容 中 的 “:)” 显 示 为 笑脸 图 片 ， 在 Android 设备 上 可 通过 SpannableString 实现 该 功能 。 





13.6.3 ”代码 示例 


编码 与 测试 方面 需要 注意 以 下 5 点 : 
(1) 如 果 把 动画 描述 定义 在 XML 文件 中 ， 动 画 定义 文件 就 要 放 在 res/anim 目录 下 。 
(2) 打开 音乐 文件 ， 要 记得 为 AndroidManifest.xml 添加 SD 卡 的 权限 配置 : 
<!--SD 卡 -> 
<uses-permission android:name="android.permission. WRITE EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.MOUNT_UNMOUNT FILESYSTEMS" /> 
(3) AndroidManifest.xml 的 application 节点 注意 补充 android:name=".MainApplication"; 
另外 ， 注 册 音 乐 播放 服务 的 service， 注 册 代码 如 下 : 
<service android:name=".service.MusicService" android:enabled="true" /> 
(4) 测试 设备 的 Android 版 本 要 求 不 低 于 Android 4.4， 因 为 属性 动画 的 暂停 和 恢复 方法 
是 在 4.4 后 引入 的 。 
(5) 要 在 真 机 上 测试 实战 项 目 ， 如 果 在 模拟 器 上 测试 ， 就 会 发 现 MP3 标题 乱码 。 这 是 因 
为 中 文 歌曲 的 MP3 标签 采用 GBK 编码 , 而 模拟 器 采用 UTF8 编码 ,两 者 对 汉字 的 编码 格式 不 
- 致 。 如 果 用 真 机 测试 ， 国 产 机 厂商 已 经 帮 我 们 解决 了 汉字 编码 问题 。 
具体 的 代码 编写 还 存在 3 个 技术 要 点 ， 记 录 如 下 : 
1. 使 用 内 容 解 析 器 ContentResolver 访问 媒体 库 


音频 资源 对 应 的 内 容 路 径 是 MediaStore.Audio.Media.EXTERNAL_CONTENT_URI， 内 容 
解析 器 通过 query 方法 访问 该 URI 获得 记录 游标 , 还 得 把 详细 记录 字段 逐个 读 取 出 来 , 音频 资 
源 的 字段 信息 说 明 见 表 13-11。 
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表 13-11 ”音频 资源 的 字段 信息 说 阴 


























MediaStore 类 的 音频 资源 字段 说 明 

Audio.Media. ID 歌曲 编号 
Audio.Media. TITLE 歌曲 的 标题 名 称 
Audio.Media. ALBUM 歌曲 的 专辑 名 称 
Audio.Media.DURATION 歌曲 的 播放 时 间 
Audio.Media.SIZE 歌曲 文件 的 大 小 
Audio.Media.ARTIST 歌曲 的 演唱 者 
Audio.Media.DATA 歌曲 文件 的 完整 路 径 


2. 解析 LRC 歌词 文件 


简要 介绍 一 下 LRC 文件 的 内 容 格式 ， 开 发 者 关心 的 主要 是 内 部 的 时 间 信 息 与 歌词 文字 。 
下 面 是 一 个 LRC 歌词 的 片段 : 

[offset:500] 

[00:26.53] 真 情 像 草原 广阔 

[00:32.78] 层 层 风 雨 不 能 阻隔 

[00:38.87] 总 有 云 开 日 出 时 候 

[00:45.68] 万 丈 阳光 照耀 你 我 

[02:26.49][00:51.68] 真 情 像 梅 花 开 过 

[02:32.68][00:57.94] 冷 冷 冰 雪 不 能 掩 没 

歌词 第 一 行 有 一 个 offset 标签 表示 歌词 标注 的 时 间 与 音乐 文件 的 时 间 偏 移 。 歌词 行 的 前 
面 是 中 括号 括 起 来 的 时 间 戳 ， 时 间 戳 的 数据 格式 为 “分 : 秒 .毫秒 ”， 表 示 该 行 歌词 的 起 始 时 间 。 
如 果 某 行 歌词 被 演唱 多 遍 ， 那 么 歌词 文字 前 面 会 有 多 个 时 间 戳 。 

3. 歌词 滚动 动画 的 播放 控制 

- 般 动 画 启 动 后 很 快 就 会 结束 ， 但 歌词 滚动 动画 不 是 这 样 的 ， 用 户 点 击 控制 条 上 的 暂停 

按钮 ， 不 但 播放 器 要 和 暂停 播放 ， 而 且 歌 词 要 和 暂停 滚动 。 平 移动 画 TranslateAnimation 不 支持 暂 
停 和 恢复 操作 ,不止 平移 动画 ,所 有 补 间 动画 都 不 支持 暂停 和 恢复 。 难 道 要 自己 重 定义 动画 ? 
山 穷 水 尽 疑 无 路 ,柳暗花明 又 一 村 。 幸 好 Android 提供 了 属性 动画 ， 不 但 支持 所 有 补 间 动画 效 
果 , 而 且 支持 暂停 和 恢复 操作 ， 还 等 什么 , 赶紧 把 TranslateAnimation 换 成 ObjectAnimator 吧 ! 

现在 音乐 播放 器 的 编码 没什么 难点 ， 如 果 不 出 状况 ,读者 就 能 很 快 看 到 自己 的 App 作品 。 
如 图 13-47 所 示 为 音乐 播放 器 的 效果 画面 。 点 击 歌曲 列表 中 的 歌 名 《一 剪 梅 》， 进 入 该 歌曲 的 
播放 界面 ， 歌 词 文字 随 着 时 间 流 逝 缓慢 向 上 滚动 ， 当 前 演唱 的 歌词 行 会 高 亮 显示 。 播 放 一 段 时 间 
后 ， 控 制 条 的 进度 移 到 右边 ， 歌 词 也 大 半 上 翻 ， 高 亮 的 歌词 行 移 向 后 面 的 文字 ， 如 图 13-48 所 示 。 
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图 13-47 “一剪梅 开始 播放 图 13-48 一剪梅 正在 播放 
接着 按 返 回 键 ， 后 退 到 歌曲 列表 页 面 ， 页 面 下 方 的 控制 条 显示 当前 的 播放 进度 ， 时 间 计 
数 随 着 歌曲 播放 而 不 断 刷新 ， 如 图 13-49 所 示 。 在 歌曲 列表 页 面 点 击 歌 名 《上 海滩 》， 进 入 该 
歌曲 的 播放 界面 ， 此 时 《一 剪 梅 》 停 止 播放 ， 转 为 播放 《上 海滩 》， 如 图 13-50 所 示 。 























图 13-49 ” 回 到 歌曲 列表 页 面 图 13-50 ”开始 播放 上 海滩 


后 下 拉 系 统 通知 栏 ， 应 该 能 够 看 到 播放 器 的 控制 条 ， 如 图 13-51 所 示 。 在 通知 栏 上 不 但 
可 以 自动 刷新 播放 进度 ， 而 且 可 以 进行 暂停 和 恢复 播放 的 操作 。 





图 13-51 通知 栏 上 的 音乐 控制 条 
下 面 是 音乐 播放 详情 界面 与 歌词 有 关 的 处 理 代码 片段 , 更 多 源码 参见 本 书 附带 源码 media 
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模块 的 MusicPlayerActivity.java、MusicDetailActivity.java 和 MusicService.java。 


private LyricsLoader mLoader;， / 声明 一 个 歌词 加 载 器 对 象 

private ArrayList<LreContent> mLrcList; / 歌词 内 容 队列 

private int mCount= 0; // 已 经 滚动 的 歌词 行 数 

private float mCurrentHeight = 0; / 当前 已 经 滚动 的 高 度 

private float mLineHeight = 0; // 每 行 歌词 的 高 度 

private int mPrePos = -1, mNextPos = 0; / 上 一 行 歌词 与 下 一 行 歌词 的 位 置 
private String mLreStr; / 当前 行 的 歌词 文本 

private ObjectAnimator animTranY; / 声明 一 个 用 于 歌词 滚动 的 属性 动画 对 象 


/ 初始 化 歌词 内 容 
private void initLre() { 

tv_mnusic = findViewById(R.idtv_music); 

/ 获得 歌词 加 载 器 的 唯一 实例 

mLoader = LyricsLoader.getInstance(mMusic.getUrl()); 

/ 通过 歌词 加 载 器 获取 歌词 内 容 队列 

mLrcList= mLoader.getLrcListO; 

/ 计算 一 行 歌词 的 高 度 

mLineHeight = Math.round(MeasureUtil.getTextHeight(" 好 ", tv_music.getTextSize())); 
b 


/ 开始 播放 音乐 
private void playMusic() { 
/ 将 歌词 内 容 队列 从 上 向 下 依次 展开 
if (mLoader.getLreList() != null && mLreList.size() > 0) { 
mLreStr =""; 
for (inti= 0; i< mLreList.sizeO; it+) { 
LrcContent item = mLreList.get(D); 
mLreStr = mLreStr + item.getLreStr( + \n"; 
} 
tv_music.setText(mLreStr); 
// 刚 进入 播放 页 面 时 ， 让 歌词 显示 淡 入 动画 
tv_music.setAnimation(AnimationUtils.loadAnimation(this, R.anim.alpha_music)); 
} 
f(app.mFilePath 一 null || !app.mFilePath.equals(mMusic.getUrl0)) { / 首次 播放 音乐 , 或 者 音 





乐 发 和 


变更 
/ 下 面 启动 音乐 播放 服务 。 具 体 的 播放 操作 在 后 台 服 务 中 完成 
Intent intent = new Intent(this, MusicService.class); 
intent.putExtra("is_play", true); 
intentputExtra("music", mMusic); 
startService(intent); 
// 延迟 150 毫秒 后 启动 歌词 刷新 任务 
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mHandlerpostDelayed(mRefreshLrc, 150); 
}else { // 音乐 已 经 在 播放 当中 了 

/ 触发 音乐 播放 进度 的 变更 处 理 

onMusicSeek(0, app.mMediaPlayer.getCurrentPosition()); 
| 
/ 延迟 100 毫秒 后 启动 控制 条 刷新 任务 
mHandler.postDelayed(mRefreshCtrl, 100); 


// 定义 一 个 控制 条 刷新 任务 
private Runnable mRefreshCtrl = new Runnable() { 
public void run0O) { 
/ 设置 音频 控制 条 的 播放 进度 
ac_play.setCurrentTime(app.mMediaPlayer.getCurrentPosition(), 0); 
if (app.mMediaPlayer.getCurrentPosition() >= app.mMediaPlayer.getDuration()) { // 已 播 完 
/ 重 置 音 频 控制 条 的 播放 进度 
ac_play.setCurrentTime(0, 0); 
} 
// 延迟 500 毫秒 后 再 次 启动 控制 条 刷新 任务 
mHandler.postDelayed(this, 500); 


Ia 


// 定义 一 个 歌词 刷新 任务 
private Runnable mRefreshLre = new Runnable() { 
public void run() { 
if (mLoader.getLreList| =— null || mLreList.size() <= 0) { 
return; 
} 
/ 计算 每 行 歌词 的 动画 
int offset = mLreList.get(mCount).getLreTime() 
- ((mCount 一 0) ? 0 : mLrcList.get(mCount - 1).getLrcTimeO) - 50; 
if (offset <=0) { 
return; 
} 
/ 开始 播放 该 行 的 歌词 滚动 动画 
startAnimation(mCurrentHeight - mLineHeight offset); 


上 
/ 在 指定 歌词 处 开始 播放 滚动 动画 


public void startAnimation(float aimHeight, int offseb { 
/ 构造 一 个 在 纵 轴 上 平移 的 属性 动画 
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animTranY = ObjectAnimatorofFloat(tv_ music, "translationY", mCurrentHeight, aimHeight); 
animTranY.setDuration(offseb; / 设置 动画 的 播放 时 长 
animTranY.setRepeatCount(0); / 重播 次 数 为 0 表示 只 播放 一 次 
animTranY.addListener(this); / 给 属性 动画 添加 动画 事件 监听 器 
animTranY.start(0); / 开始 播放 属性 动画 
mCurrentHeight = aimHeight; 
让 (lapp.mMediaPlayerisPlaying()) { / 媒体 播放 器 不 在 播放 
// 延迟 若干 时 间 后 启动 歌词 暂停 滚动 任务 
mHandler.postDelayed(new Runnable() { 
(QOverride 
public void run() { 
animTranY.pause(); / 歌词 滚动 动画 暂停 播放 
} 
}, offset + 100); 
} 
} 
// 在 属性 动画 结束 播放 时 触发 
public void onAnimationEnd(Animator animation) { 
if (mCount <mLreList.size()) { 
mNextPos = mLreStr.indexOf("\n", mPrePos + 1); 
// 创建 一 个 可 变 字符 串 
SpannableString spanText = new SpannableString(mLreStr); 
/ 高 亮 显示 当前 正在 播放 的 歌词 文本 
spanText.setSpan(new ForegroundColorSpan(Color.RED), mPrePos + 1, 
mNextPos > 0 ? mNextPos : mLreStr.length() - 1, 
Spanned.SPAN_EXCLUSIVE EXCLUSIVE); 
mCounttt+; 
// 在 文本 视图 中 显示 高 亮 处 理 后 的 可 变 字符 串 
tv_music.setText(spanText); 
if (mNextPos > 0 && mNextPos <mLreStr.length() - 1) { 
mPrePos = mLrceStr.indexOf("\n", mNextPos); 
/ 延迟 50 毫秒 后 启动 歌词 刷新 任务 
mHandler.postDelayed(mRefreshLre, 50); 


13.7 小 结 


本 章 主要 介绍 App 开发 用 到 的 常见 多 媒体 技术 ,包括 几 种 常见 的 图 片 查 看 控件 (画廊 、 
图 像 切换 器 、 卡 片 视图 、 调 色 板 )、 几 种 常见 的 音频 播放 工具 (铃声 工具 、 声 音 池 、 音 轨 录 播 ) 、 
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几 种 常见 的 视频 播放 控件 〈 视 频 视图 、 媒 体 控制 条 、 自 定义 播放 控制 条 ) 、 几 种 划分 屏幕 多 窗 
口 的 模式 〈 分 屏 、 画 中 画 、 自 定义 悬浮 窗 、 截 图 和 录 屏 ) 。 最 后 设计 了 两 个 实战 项 目 ， 一 个 是 
“影视 播放 器 一 一 爱 看 剧场 ”， 另 一 个 是 “音乐 播放 器 一 一 浪花 相册 ”。 在 “影视 播放 器 
爱 看 剧场 ”的 项 目 编码 中 ， 除 了 采取 常规 的 视频 播放 技术 之 外 ， 还 综合 考虑 了 分 屏 /全 屏 、 竖 
屏 / 横 屏 、 正 常 屏 / 画 中 画 这 几 种 变化 时 的 屏幕 适 配 处 理 。 在 “音乐 播放 器 一 一 浪花 相册 ”的 项 
目 编码 中 ， 采 用 了 本 书 到 目前 为 止 的 主要 技术 点 ， 实 现 了 歌曲 的 播放 控制 和 歌词 的 滚动 显示 。 
另外 ， 介 绍 了 可 变 字符 串 的 种 类 及 其 使 用 说 明 。 
通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 5 种 开发 技能 : 


(1) 学 会 如 何 使 用 图 像 控件 实现 自 定义 相册 。 

(2) 学 会 如 何 使 用 视频 控件 实现 影视 播放 器 。 

(3) 学 会 如 何 使 用 音频 控件 实现 音乐 播放 器 。 

(4) 学 会 在 合适 的 场景 中 恰当 运用 屏幕 多 窗口 模式 。 

(5) 学 会 借助 可 变 字符 串 在 一 段 文本 中 运用 不 同 的 风格 样式 。 





第 14 章 


融合 技术 


本 章 介绍 融合 技术 的 几 个 方向 ， 主 要 包括 使 用 网 页 集成 技术 实现 不 同 终端 显示 同一 个 网 
页 、 使 用 JNI 开发 技术 实现 不 同 平台 运行 同一 套 代码 、 使 用 局 域 网 共享 技术 实现 不 同 设备 分 享 
同一 份 文件 。 最 后 结合 本 章 所 学 的 知识 分 别 演示 了 两 个 实战 项 目 “WiFi 共享 器 ”和 “电子 书 
阅读 器 ”的 设计 与 实现 。 


14.1 网 页 集成 


本 节 介绍 融合 技术 的 一 个 重要 方向 一 网 页 集成 ，Web 页 面 可 以 直接 在 Android、iOS、 
Windows 等 终端 上 显示 ， 能 够 减少 重复 的 适 配 工作 ， 有 效 降低 开发 成 本 。 本 节 首 先 说 明 如 何 
使 用 资产 管理 器 打开 文本 文件 、 图 片 文件 以 及 加 载 网 页 ， 接 着 逐步 六 述 网 页 视图 的 详细 用 法 ， 
最 后 利用 网 页 视图 实现 一 个 简单 浏览 器 。 


14.1.1 资产 管理 器 AssetManager 


如 同 所 有 的 应 用 程序 那样 , App 运行 时 也 要 读 取 事 先 定义 好 的 配置 信息 , 并 加 载 图 片 等 资 
源 文件 。 一 般 情况 下 ， 这 些 配 置信 息 与 资源 文件 可 以 放 在 工程 的 res 目录 中 ， 举 例如 下 : 


(1) 图 片 文件 与 图 形 定义 文件 可 以 放 在 res/drawable 目录 。 
(2) 字符 串 定 义 可 以 放 在 res/values/strings.xml 文件 中 。 
(3) 颜色 值 定 义 可 以 放 在 res/values/colors.xml 文件 中 。 
(4) 整 型 数 定义 可 以 放 在 res/values/integers.xml 文件 中 。 
(5) 各 类 数组 定义 可 以 放 在 res/values/arrays.xml 文件 中 。 
(6) 音频 等 其 他 二 进 制 流 文件 可 以 放 在 res/raw 目录 。 
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乍 看 之 下 ，res 目录 已 经 允许 保存 几乎 所 有 配置 信息 与 资源 文件 了 ， 不 过 事情 往往 存在 各 

种 预料 之 外 的 情况 ， 比 如 以 下 业务 场景 就 无 法 使 用 res 配置 : 

(1) 大 批量 的 初始 化 数据 ， 需 要 在 App 第 一 次 安装 时 导入 数据 库 。 因 为 res/values 目录 
下 放 的 是 键 值 对 数据 (如 key-value ) ， 难 以 转换 为 数据 库 中 存储 的 关系 型 数据 。 

(2) 工程 源码 要 导出 为 JAR 包 ， 作 为 一 个 SDK 给 其 他 工程 使 用 。 因 为 res 目录 无 法 集成 
到 jar 包 中 ， 所 以 待 集成 的 图 片 资源 不 可 放 在 res 目录 。 

(3) 如 网 页 HTML 这 种 需要 保持 原 有 格式 的 文件 ， 不 适合 放 在 res 目录 中 进行 编译 。 

(4) 其 余 无 法 被 Android 系统 识别 的 文件 格式 ， 如 电子 书 的 pdf、epub、djvu 等 等 。 


基于 此 ，Android 提供 了 一 个 assets 目录 用 来 保存 以 上 特殊 需求 的 文件 。 在 Android Studio 
中 创建 一 个 新 模块 ， 默 认 没有 assets 目录 ， 开 发 者 得 自己 在 src/main 目录 下 新 建 assets 目录 ， 
然后 在 该 目录 中 存放 各 种 要 求 保持 原 有 格式 的 文件 。 

因为 assets 目录 下 的 资产 文件 不 会 被 系统 编译 ， 所 以 无 法 通过 R.*.* 这 种 方式 访问 ， 需 要 
使 用 另外 的 工具 一 一 资产 管理 器 AssetManager 访问 。 通 过 该 工具 ， 我 们 能 够 以 输入 流 方 式 打 
开 assets 目录 的 文件 ， 并 将 输入 流转 换 为 文本 或 图 像 。 

在 页 面 代码 中 调用 getAssets 方法 可 获得 AssetManager 对 象 ， 下 面 是 它 的 常用 方法 说 明 。 

e list: 列 出 指定 目录 下 的 文件 与 文件 夹 列表 数组 。 

e@ open: 打开 资产 文件 ， 返 回 输入 流 InputStream 对 象 。 访 问 模式 默认 是 AssetManager. 

ACCESS_STREAMING， 表 示 流 式 访 问 ， 即 顺序 读 取 。 
@ close: 关闭 资产 管理 器 。 


assets 目录 保存 的 多 是 文本 文件 与 图 片 文件 。 使 用 AssetManager 读 取 文本 和 图 像 的 代码 如 下 : 


/ 从 asset 资产 文件 中 获取 文本 字符 串 
public static String getTxtFromAssets(Context context, String fileName) { 
String result = ""; 
try 
InputStream is = context.getAssets(.open(fileName); / 打开 资产 文件 并 获得 输入 流 
int lenght = is.available(); 
byte[] buffer = new byte[lenght]; 
is.read(buffer); 
result = new String(buffer, "utf8"); 
} catch (Exception e) { 
e.printStack Trace(); 
b 
return result; 


) 


// 从 asset 资产 文件 中 获取 位 图 对 象 

public static Bitmap getImgFromAssets(Context context, String fileName) { 
Bitmap bitmap = null; 
try{ 
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InputStream is = context.getAssets(.open(fileName); / 打开 资产 文件 并 获得 输入 流 
bitmap = BitmapFactory.decodeStream(is); // 解析 输入 流 得 到 位 图 数据 

} catch (Exception e) { 
e.printStack Trace(); 


} 
return bitmap; 


} 
资产 管理 器 读 取 文 本 与 图 像 的 效果 如 图 14-1 和 图 14-2 所 示 。 其 中 ， 如 图 14-1 所 示 为 从 
assets 目录 读 取 并 显示 文本 文件 的 画面 , 如 图 14-2 所 示 为 从 assets 目录 读 取 并 显示 图 片 文件 的 
画面 。 


mixture mixture 


下 面 文字 来 源 于 资产 文件 file/libai.txt 
望 访 山 瀑布 
李白 


下 面 图 像 来 源 于 资产 文件 file/water.jpg 


日 照 香炉 生 紫 烟 ， 
遥 看 瀑布 挂 前 川 。 
飞 流 直下 三 干 尺 ， 
疑 是 银河 落 九天 。 





图 14-1 从 资产 目录 读 取 文本 图 14-2 从 资产 目录 读 取 图 片 


14.1.2 ”网 页 视图 WebView 














前 面 提 到 assets 目录 可 保存 网 页 文件 ， 由 于 网 页 不 是 一 般 的 文本 文件 ， 而 是 包含 一 系列 
HTML 标签 的 页 面 描述 定义 ， 因 此 如 果 想 显示 网 页 的 效果 画面 而 非 源 代码 ， 就 得 借助 于 网 页 
视图 WebView。WebView 相当 于 Android 的 一 个 浏览 器 内 核 ， 可 内 购并 展示 Web 页 面 ， 并 处 
理 App 与 Web 的 交互 操作 。 

调用 WebView 对 象 的 loadUrl 方法 可 让 网 页 视图 显示 资产 目录 中 的 网 页 ， 注 意 要 在 网 页 
路 径 前 加 上 “file:///android_asset/”， 表 示 该 网 页 来 自 于 本 地 的 assets 目录 ， 有 具体 代码 如 下 : 

public class WebLocalActivity extends AppCompatActivity { 

Private String mFilePath = "file:///android_asset/html/index.html"; 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_web_local); 
TextView tv_web _path = findViewById(R.id.tv_web_path); 
// 从 布局 文件 中 获取 名 叫 wv_assets_web 的 网 页 视图 
WebView wv_assets web = findViewById(R.id.wv_assets_web); 
tv_web path.setText(" 下 面 网 页 来 源 于 资产 文件 : "+ mFilePath); 
/ 命令 网 页 视图 加 载 指定 路 径 的 网 页 
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wv_assets_web.loadUrl(mFilePath); 
/ 给 网 页 视图 设置 默认 的 网 页 浏览 客户 端 
wv_assets web.setWebViewClient(new WebViewClientO); 
} 
WebView 展示 本 地 网 页 的 效果 如 图 14-3 所 示 。 页 面 左边 是 图 片 ， 右 边 是 诗歌 的 文本 。 


下 面 网 页 来 源 于 资产 文件 fle:/// 
android_asset/html/index.html 


望 庐山 瀑布 
李白 


日 照 香 炉 生 紫 烟 ， 
遥 看 瀑布 挂 前 川 。 
尺 ， 


三 干 
疑 是 银河 落 九 天 。 








图 14-3 ”从 资产 目录 读 取 网 页 


网 页 视图 可 以 访问 本 地 网 页 ， 也 可 以 访问 外 部 网 页 。 在 电脑 浏览 器 上 查看 网 页 时 经 常 通 
过 点 击 超 链接 打开 新 窗口 。 在 手机 上 ，App 要 实现 超 链接 跳 转 ， 可 参 归 第 13 章 的 可 变 字符 串 
UrlSpan， 该 风格 把 指定 位 置 的 文字 转 为 超 链接 ， 点 击 超 链接 文字 即 可 跳 转 到 相应 URL。 注 意 
这 里 的 跳 转 URL 其 实 是 在 一 个 网 页 视图 中 打开 的 。 

看 来 App 针对 超 链接 的 处 理 比 HTML 复杂 ， 虽 然 复 杂 了 点 ， 但 是 套用 固定 的 代码 模板 使 
用 也 不 难 。 使 用 超 链 接 风格 打开 网 页 视图 的 代码 如 下 : 

/ 显示 超 链接 的 文字 风格 
private void showUrlSpan0 { 
/ 创建 一 个 可 变 字符 串 
SpannableString spanText = new SpannableString(mText); 
/ 设置 tv_spannable 内 部 文本 的 移动 方式 为 超 链 移动 
/ 调用 setMovementMethod 方法 之 后 ， 点 击 超 链 接 才 有 反应 
tv_spannable.setMovementMethod(Link MovementMethod.getInstance()); 
/ 从 HTML 标记 中 获取 可 变 对 象 
Spannable sp = (Spannable) Html.fromHtml("<a hre=\"\">" + mKey + "</a>"); 
CharSequence text = sp.toString(); 
// 生成 超 链接 的 风格 数组 
URLSpan[] urls = sp.getSpans(0, text.length(), URLSpan.class); 
for (URLSpan url : urls) { 
// 给 可 变 字符 串 设置 超 链接 风格 
MyURLSpan myURLSpan = new MyURLSpan(url.getURL()); 
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spanText.setSpan(myURLSpan, mBeginPos, mEndPos, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE):; 
} 
tv_spannable.setText(spanText); 
} 


// 定义 一 个 超 链接 的 风格 ， 用 于 指定 点 击 事件 的 逻辑 处 理 
private class MyURLSpan extends URLSpan { 
public MyURLSpan(String url) { 
super(urD); 
} 


/ 在 点 击 超 链 文 字 时 触发 

public void onClick(View widget) { 
wv_spannable.setVisibility(View.VISIBLE):; 
// 命令 网 页 视图 加 载 指定 路 径 的 网 页 
wv_spannable.loadUrl("http://blog.csdn.net/aqi00"); 
// 网 页 视图 请 求 获得 焦点 
wv_spannable.requestFocus(); 
/ 给 网 页 视图 设置 默认 的 网 页 浏览 客户 端 
wv_spannable.setWebViewClient(new WebViewClient()); 


} 


超 链接 风格 的 文字 效果 如 图 14-4 所 示 。 文 字 加 
了 下 划 线 ， 并 且 文 字 与 下 划 线 都 高 亮 显示 。 点 击 超 
链接 后 ， 在 网 页 视图 中 打开 指定 的 URL 地 址 ， 显 可 变 字 符 帅 样式 :起 链 接 





示 的 Web 页 面 如 图 14-5 所 示 ， 看 起 来 是 手机 版 的 为 人 民 服 务 
网 页 。 < CSDN 博 客 
鲁 湖 前 琴 亭 三 
四 四 
54 万 + 3309 201 900 
博文 分 类 专栏 





【 赠 书 活动 ] 清华 社 的 两 本 Android 技 术 书 籍 





可 变 字符 串 样式 超 链接 


Kotlin 入 门 教程 一目 录 索 引 
为 人 民 服 务 











图 14-4” 超 链接 风格 的 文字 效果 图 14-5 点击 超 链接 打开 网 页 
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14.1.3 ”简单 浏览 器 


注意 前 面 使 用 的 WebView, 除了 调用 loadUnl 方法 外 , 还 调用 了 其 他 方法 (如 setWebViewClient 
等 ) 。 下 面 说 明 WebView 的 常用 方法 。 


e。 loadUrl: 加 载 指定 的 URL，URL 可 以 是 HTTP 打头 的 外 部 网 址 ， 也 可 以 是 file 打头 的 
资产 网 页 。 

e getSettings: 获取 浏览 器 的 网 页 设置 信息 。 返 回 一 个 网 页 设置 WebSettings 对 象 。 

e@ addJavascriptInterface: 添加 供 JavaScript 调用 的 App 接口 。 

e@ setWebViewClient: 设置 网 页 视图 的 网 页 浏览 客户 端 WebViewClient， 如 果 已 调用 
loadUrl 方法 ， 就 必须 同时 调用 本 方法 。 

esetWebChromeClient: 设置 浏览 器 的 网 页 交互 客户 端 WebChromeClient。 

ee ”setDownloadListener: 设置 文件 下 载 监听 器 DownloadListener。 

eloadData: 加 载 文本 数据 。 第 二 个 参数 表示 媒体 类 型 ， 如 text/html; 第 三 个 参数 表示 数 

据 的 编码 格式 ， 如 base64 表示 采用 BASE64 编码 ， 其 余 值 (包括 null ) 表示 URL 纺 

码 。 

canGoBack: 判断 页 面 能 否 返回 。 

goBack: 返回 上 一 个 页 面 。 

canGoForward: 判断 页 面 能 否 前 进 。 

goForward: 前 进 到 下 一 个 页 面 。 

reload: 重新 加 载 页 面 。 

stopLoading: 停止 加 载 页 面 。 


上 述 方法 中 有 4 个 组 件 需 要 补充 描述 ， 包 括 网 页 设置 WebSettings、 网 页 视图 客户 端 
WebViewClient、 网 页 交互 客户 端 WebChromeClient 和 文件 下 载 监听 器 DownloadListener。 


1. 网 页 设置 WebSettings 


WebSettings 用 于 管理 网 页 视图 的 加 载 属性 , 指明 了 什么 该 做 、 什 么 不 该 做 。 调 用 WebView 
对 象 的 getSettings 方法 即 可 获得 WebSettings 对 象 。 下 面 是 WebSettings 的 常用 设置 方法 。 
以 下 是 基本 的 加 载 设置 。 


esetLoadsImagesAutomatically: 设置 是 否 自动 加 载 图 片 。 如 果 设 置 为 false， 就 表示 无 图 
模式 。 

esetDefaultTextEncodingName: 设置 默认 的 文本 编码 ， 如 UTF-8、GBK 等 。 

e@ setJavaScriptEnabled: 设置 是 否 支 持 JavaScript。 

e@ setJavaScriptCanOpenWindowsAutomatically: 设置 是 否 允 许 JavaScript 自动 打开 新 窗 
口 ， 即 JS 的 window.open 方法 是 否 适用 。 


以 下 是 与 网 页 适 配 有 关 的 设置 。 


e@ setSupportZoom: 设置 是 否 支持 页 面 缩放 。 
e@ setBuiltitnZoomControls: 设置 是 否 出 现 缩放 工具 。 
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setUseWideViewPort: 当 容 器 超过 页 面 大 小 时 ， 是 否 将 页 面 放大 到 塞 满 容器 宽度 的 尺 
寸 。 

setLoadWithOverviewMode: 当 页 面 超 过 容器 大 小 时 ， 是 否 将 页 面 缩 小 到 容器 能 够 装 下 的 
尺寸 。 

setLayoutAlgorithm: 设置 自 适应 屏幕 的 算法 , 一 般 是 LayoutAlgorithm.SINGLE _ COLUMN。 
如 果 不 设置 ，Android 4.2.2 及 之 前 的 版 本 就 可 能 出 现 表格 错乱 的 情况 。 


以 下 是 与 存储 有 关 的 设置 。 


setAppCacheEnabled: 设置 是 否 启用 App 缓存 。 

setAppCachePath: 设置 App 缓存 文件 的 路 径 。 

setAllowFileAccess: 设置 是 否 允 许 访问 文件 ， 如 WebView 访问 SD 卡 的 文件 。 
setDatabaseEnabled: 设置 是 否 启 用 数据 库 。 

setDomStorageEnabled: 设置 是 否 启 用 本 地 存储 。 

setCacheMode: 设置 使 用 的 缓存 模式 。 缓 存 模式 的 取 值 说 明 见 表 14-1。 


表 14-1 ”缓存 模式 的 取 值 说 明 


WebSettings 类 的 缓存 模式 说 明 
LOAD CACHE ELSE NETWORK 优先 使 用 缓存 





LOAD_NO_CACHE 不 使 用 缓存 








LOAD CACHE ONLY 只 使 用 缓存 


2. 


网 页 视图 客户 端 WebViewClient 


可 以 将 WebViewClient 看 作 网 页 加 载 监 听 器 , 用 于 处 理 与 加 载 动 作 有 关 的 事件 , WebView 
对 象 调用 setWebViewClient 方法 即 可 设置 客户 端 。 需 要 重 写 以 下 方法 说 明 。 


onPageStarted: 页 面 开始 加 载 时 触发 。 可 在 此 弹出 进度 对 话 框 ProgressFialog。 
onPageFinished: 页 面 加 载 结 束 时 触发 。 可 在 此 关闭 进度 对 话 框 。 

onReceivedError: 收 到 错误 信息 时 触发 。 

onReceivedSslError: 收 到 SSL 错误 时 触发 。 

shouldOverrideUrlLoading: 发 生 网 页 跳 转 时 触发 。 重 写 该 方法 的 目的 是 判断 每 当 点 击 网 
页 中 的 链接 时 ， 是 想 在 当前 的 网 页 视图 里 跳 转 还 是 跳 转 到 系统 自 带 的 浏览 器 。 


在 当前 的 网 页 视图 内 部 跳 转 ， 重 写 方法 代码 如 下 : 


3. 


/ 发 生 网 页 跳 转 时 触发 

public boolean shouldOverrideUrlLoading( WebView view, String url) { 
view.loadUrl(url); // 在 当前 的 网 页 视图 内 部 跳 转 
return true; 


} 
网 页 交互 客户 端 WebChromeClient 


WebChromeClient 用 于 处 理 网 页 与 App 之 间 的 交互 事件 ，WebView 对 象 调用 
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setWebChromeClient 方法 即 可 设置 客户 端 。WebChromeClient 需要 重 写 的 方法 说 明 如 下 。 


onReceivedTitle: 收 到 页 面 标题 时 触发 。 
onProgressChanged: 页 面 加 载 进度 发 生变 化 时 触发 。 可 在 此 刷新 进度 对 话 框 的 进度 条 。 
onJsAlert: 网 页 的 JS 代码 调用 alert 方法 时 触发 。 可 在 此 弹出 自 定义 的 提示 对 话 框 。 
onJsConfirm: 网 页 的 JS 代码 调用 confirm 方法 时 触发 。 可 在 此 弹出 自 定义 的 确认 对 话 框 。 
onJsPrompt: 网 页 的 JS 代码 调用 prompt 方 法 时 触发 。 可 在 此 弹出 自 定义 的 提示 对 话 框 。 
onGeolocationPermissionsShowPrompt: 网 页 请 求 定位 权限 时 触发 。 可 在 此 弹出 一 个 确 
认 对 话 框 ， 提 示 用 户 是 否 允 许 网 页 获得 定位 权限 。 如 果 不 想 出 现 弹 窗 就 允许 网 页 获得 
权限 ， 重 写 方法 代码 如 下 : 

/ 网 页 请 求 定位 权限 时 触发 

public void onGeolocationPermissionsShowPrompt(String origin, Callback callback) { 


callback.invoke(origin, true, false); / 不 弹 窗 就 允许 网 页 获得 定位 权限 
super.onGeolocationPermissionsShowPrompt(origin, callback); 


册 
4. 文件 下 载 监听 器 DownloadListener 


DownloadListener 用 于 监听 网 页 的 下 载 事 件 ，WebView 对 象 调用 setDownloadListener 方 
法 即 可 设置 下 载 监听 器 。DownloadListener 只 有 onDownloadStart 方法 需要 重 写 。 


e@ onDownloadStart: 文件 开始 下 载 触 发 。 可 在 此 接管 下 载 动作 ， 比 如 设置 文件 下 载 的 方 
式 、 文 件 的 保存 路 径 等 。 


了 解 网 页 视图 相关 组 件 的 具体 用 法 后 ， 接 下 来 让 我 们 实现 一 个 简单 的 浏览 器 ， 进 一 步 加 
深 对 WebView 运用 的 理解 。 下 面 是 使 用 WebView 实现 简单 浏览 器 的 代码 : 


public class WebBrowserActivity extends AppCompatActivity implements OnClickListener { 
private EditText et_web_url; / 声明 一 个 用 于 输入 网 址 的 编辑 框 对 象 
private WebView wv_web; / 声明 一 个 网 页 视图 对 象 
private ProgressDialog mDialog; // 声明 一 个 进度 对 话 框 对 象 
private String mUrl / 完整 的 网 页 地 址 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_web_browser); 
et_web_url = findViewById(R.id.et_web_ur); 
et_web_url.setText("xw.qq.com/"); 
/ 从 布局 文件 中 获取 名 叫 wv_web 的 网 页 视图 
wv_web = findViewById(R.id.wv_web); 
findViewByld(R.id.btn_web go).setOnClickListener(this); 
findViewByld(R.id.ib_back).setOnClickListener(this); 
findViewByld(R.id.ib_forward).setOnClickListener(this); 
findViewByld(R.id.ib_refresh).setOnClickListener(this); 
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findViewById(R.id.ib_close).setOnClickListener(this); 
initWebViewSettings(); / 初始 化 网 页 视图 的 网 页 设置 


// 初始 化 网 页 视图 的 网 页 设置 
private void initWebViewSettings() { 


) 


/ 获取 网 页 视图 的 网 页 设置 

WebSettings settings = wv_web.getSettings(); 

/ 设置 是 否 自 动 加 载 图 片 
settings.setLoadsImagesAutomatically(true); 

/ 设置 默认 的 文本 编码 

settings.setDefaultTextEncoding Name("utf-8"); 

/ 设置 是 否 支 持 JavaScript 

settings.setJavaScriptEnabled(true); 

/ 设置 是 否 允 许 JavaScript 自动 打开 新 窗口 (window.open()) 
settings.setJavaScriptCanOpenWindowsAutomatically(false); 

/ 设置 是 否 支持 缩放 

settings.setSupportZoom(true); 

/ 设置 是 否 出 现 缩放 工具 

settings.setBuiltInZoomControls(true); 

// 当 容器 超过 页 面 大 小 时 ， 是 否 放 大 页 面 大 小 到 容器 宽度 
settings.setUse WideViewPort(true); 

// 当 页 面 超 过 容器 大 小 时 ， 是 否 缩小 页 面 尺 寸 到 页 面 宽度 
settings.setLoadWithOverviewMode(true); 

/ 设置 自 适应 屏幕 。4.2.2 及 之 前 版 本 自 适 应 时 可 能 会 出 现 表格 错乱 的 情况 
settings.setLayoutAlgorithm(LayoutAlgorithm.SINGLE_COLUMN); 


public void onClick(View v) { 


让 (v.getId0) 一 R.id.btn_web_go) { // 点 击 了 “ 快 去 ”按钮 
/ 从 系统 服务 中 获取 输入 法 管理 器 
InputMethodManager imm = (Input MethodManager) 

getSystemService(Context.INPUT METHOD SERVICE); 

// 关闭 输入 法 软 键盘 
imm.hideSoftInputFromWindow(et_web_url.getWindowToken(), 0); 
mUrl = "http://" + et_web_url.getText().toString(); 
// 命令 网 页 视图 加 载 指定 路 径 的 网 页 
wv_web.loadUrl(mUr)); 
// 给 网 页 视图 设置 自 定义 的 网 页 浏览 客户 端 
wv_web.setWebViewClient(mWebViewClient); 
// 给 网 页 视图 设置 自 定义 的 网 页 交互 客户 端 
wv_web.setWebChromeClient(mWebChrome); 

} elseif(v.getId0 一 R.id.ib_back) { // 点 击 了 后 退 图 标 


第 14 章 融合 技术 | 655 





让 (wv_web.canGoBack()) { / 如 果 能 够 后 退 
wv_web.goBack();，// 回 到 上 一 个 网 页 
}else{ 
Toast.makeText(this, "已 经 是 最 后 一 页 了 ", Toast. LENGTH_SHORT).show(); 
} 
} else if (v.getId() 一 R.id.ib forward) { // 点 击 了 前 进 图 标 
让 (wv_web.canGoForward()) { // 如 果 能 够 前 进 
wv_web.goForward(); // 去 往 下 一 个 网 页 
}else{ 
Toast.makeText(this, "已 经 是 最 前 一 页 了 ", ToastLENGTH SHORT).show0; 
} else if (v.getId() 一 R.id.ib_refresh) { / 点 击 了 刷新 图 标 
wv_webxreload(); / 命令 网 页 视图 重新 加 载 网 页 
/lwv_web.stopLoading(); / 停止 加 载 
} else if (v.getId() 一 R.id.ib_close) { V 点 击 了 关闭 图 标 
finish();，// 关闭 当前 页 面 
上 


// 在 按 下 返回 键 时 触发 
public void onBackPressed() { 
让 (wv_web.canGoBack() && !Iwv_web.getUrl().equals(mUrD)) { // 还 能 返回 到 上 一 个 网 页 
wv_web.goBack();，// 回 到 上 一 个 网 页 
} else { // 已 经 是 最 早 的 网 页 ， 无 路 返回 了 
finish(); / 关闭 当前 页 面 
} 
! 


// 定义 一 个 网 页 浏览 客户 端 
private WebViewClient mWebViewClient = new WebViewClientO { 
/ 收 到 SSL 错误 时 触发 
public void onReceivedSslEror(WebView view, SslErorHandler handler, SslError error) { 
handler.proceed(); 
b 


// 页 面 开始 加 载 时 触发 
public void onPageStarted( WebView view, String url, Bitmap favicon) { 
super.onPageStarted(view, url, favicon); 
if (mDialog == null | !mDialog.isShowing()) { 
// 下 面 弹出 提示 网 页 正在 加 载 的 进度 对 话 框 
mDialog = new ProgressDialog( WebBrowserActivity.this); 
mDialog.setTitle(" 稍 等 "); 
mDialog.setMessage(" 页 面 加 载 中 ……"); 
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mDialog.setProgressStyle(ProgressDialog. STYLE_ HORIZONTAL); 
mDialog.show(); / 显示 进度 对 话 框 


} 


/ 页 面 加 载 结束 时 触发 
public void onPageFinished(WebView view, String url) { 
super.onPageFinished(view, urD); 
if (mDialog != null && mDialog.isShowing()) { 
mDialog.dismiss(); / 关闭 进度 对 话 框 
} 
} 


/ 收 到 错误 信息 时 触发 
public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) { 
super.onReceivedError(view, errorCode, description, failingUr); 
if (mDialog != null && mDialog.isShowing()) { 
mDialog.dismiss();，// 关闭 进度 对 话 框 
了 
Toast.make Text(WebBrowserActivity.this, 
"页 面 加 载 失败 ， 请 稍 候 再 试 ", Toast.LENGTH_LONG).show0; 
b 


// 发 生 网 页 跳 转 时 触发 
public boolean shouldOverrideUrlLoading(WebView view, String url) { 
view.loadUrl(url);，// 在 当前 的 网 页 视图 内 部 跳 转 


return true; 
上 


/ 定义 一 个 网 页 交互 客户 端 
private WebChromeClient mWebChrome = new WebChromeClientO { 
/ 页 面 加 载 进度 发 生变 化 时 触发 
public void onProgressChanged(WebView view, int progress) { 
if (mDialog != null && mDialog.isShowing() { 
mDialog.setProgress(progress); // 更 新 进度 对 话 框 的 加 载 进 度 


上 


/ 网 页 请 求 定位 权限 时 触发 

public void onGeolocationPermissionsShowPrompt(String origin, Callback callback) { 
callback.invoke(origin, true, false); // 不 弹 窗 就 允许 网 页 获得 定位 权限 
super.onGeolocationPermissionsShowPrompt(origin, callback); 
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} 


简单 浏览 器 的 展示 效果 如 图 14-6 一 图 14-9 所 示 。 其 中 ， 如 图 14-6 所 示 为 打开 浏览 器 的 初 
始 页 面 , 页 面 上 部 为 地 址 栏 , 下 部 为 控制 栏 (从 左 到 右 依次 是 前 进 、 后 退 、 刷新、 退出 等 按钮 ); 
在 地 址 栏 输入 网 址 并 点 击 “ 快 去 ”按钮 ， 浏 览 器 显示 正在 加 载 的 进度 对 话 框 ， 如 图 14-7 所 示 ; 
网 页 加 载 完毕 后 , 进度 对 话 框 消失 , 浏览 器 主 视图 中 显示 该 网 址 的 Web 页 面 , 如 图 14-8 所 示 ; 
点 击 该 页 面 的 第 一 条 新 闻 ， 浏 览 器 打开 该 新 闻 的 详情 页 面 ， 如 图 14-9 所 示 。 








en 
OCS 
图 14-6 浏览 器 的 初始 界面 图 14-7 浏览 器 加 载 网 页 中 
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图 14-8 浏览 器 加 载 网 页 完成 图 14-9 点 击 进入 新 闻 详 情 页 
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要 想 在 前 后 网 页 中 切换 ， 可 点 击 下 方 控制 栏 的 前 进 或 后 退 按钮 要 想 重新 加 载 当前 网 页 ， 
可 点 击 控制 栏 的 刷新 按钮 ， 要 想 退 出 浏览 器 ， 可 点 击 控制 栏 右边 的 退出 按钮 。 读 者 若 有 兴 
也 可 加 入 其 他 高 级 功能 ， 如 设置 默认 主页 、 开 启 无 图 模式 、 添 加 书签 管理 等 内 容 。 


14.2 ”JNI 开 发 


本 节 介 绍 融 合 技 术 的 一 个 重要 方向 一 一 JNI 开发 。C/C++ 语 言 具 有 跨 平台 的 特性 ， 苹 果 操 

作 系 统 能 够 直接 运行 C/C++ 代码 , 如 果 功 能 采用 C/C++ 实现 , 就 很 容易 在 不 同 平台 (如 Android 

与 iOS) 之 间 移植 。 本 节 首 先 说 明 如 何在 Android Studio 中 搭建 NDK 编译 环境 ， 接 着 阐述 如 

何 使 用 JNI 接口 完成 Java 代码 对 C 代码 的 调用 ， 最 后 描述 JNI 技术 适用 的 业务 场景 ， 并 给 出 
-个 实际 需求 的 应 用 项 目 “JNI 实现 加 解密 ”。 


14.2.1 ”NDK 环境 搭建 





完整 的 Android Studio 环境 包括 3 个 开发 工具 ， 即 JDK、SDK 和 NDK， 早 在 第 1 章 就 对 
这 些 工具 做 了 介绍 ， 这 里 不 妨 复 习 一 下 。 
(1) JDK 是 Java 语 言 的 编译 器 ， 因 为 App 采 用 Java 语 言 开 发 ， 所 以 开发 机 上 要 先 安装 JDK。 
(2) SDK 是 Android 应 用 的 编译 器 ， 提 供 了 Android 内 核 的 公共 API 调用 ， 所 以 开发 
App 必须 安装 SDK。 
(3) NDK 是 C/C++ 代码 的 编译 器 ， 如 果 App 未 使 用 JNI 技术 ， 就 无 须 安装 NDK; 如 果 
App 用 到 JNI， 就 必须 安装 NDK。 


NDK 允许 开发 者 在 App 中 通过 C/C++ 代码 执行 部 分 操作 , 然后 由 Java 代码 通过 JNI 接口 
调用 C/C++ 代码 。 既 然 本 节 讲 的 是 JNI 开发 ， 那 么 肯定 要 给 Android Studio 安装 NDK。 

下 面 是 NDK 环境 的 搭建 步骤 说 明 。 

人 EXo) 到 谷歌 开发 者 网 站 下 载 最 新 的 NDK 开发 包 ， 下 载 页 面 地 址 是 
https://developer.android.google.cn/ndk/downloads/index.html。 下 载 完 毕 后 ， 解 压 到 本 地 路 径 ， 比 如 
笔者 把 NDK 解压 到 了 D:\Android\android-ndk-r17。 注 意 目 录 名 称 不 要 有 中 文 。 

C3702 在 系统 中 增加 NDK 的 环境 变量 定义 ， 如 变量 名 为 NDK ROOT， 变量 值 为 
D\Android\android-ndk-r17。 另 外 ， 在 Path 变量 值 后 面 补充 ;%NDK_ROOT%。 

CI03 在 项 目 名 称 上 右 击 ， 然 后 在 弹出 的 菜单 项 中 选择 Open Module Settings， 打 开设 置 页 
， 如 图 14-10 所 示 。 也 可 依次 选择 菜单 File 一 Project Structure 打开 设置 页 面 。 




















第 14 章 融合 技术 | 659 





Vairture Reformat Code Ctrl+Alt+L 
netvork Optinmize Imports Ctrl+Alt+0 
Wperfornance 
sthirdsdk 
veirxin 

@6radle Scripts 

你 External Build Files Directory Path Ctrl+Alt+F12 


范 Conpare With... Ctrl+D 


Local History » 
© Synchronize "nixture’ 


Show in Explorer 





Q Create Gist... 


14-10 在 右键 菜单 中 进入 设置 页 面 





在 打开 的 设置 页 面 中 依次 找到 SDK Location 一 NDK Location, 设置 前 面 解压 的 NDK 目录 路 径 ， 





然后 单 击 OK 








按钮 ， 设 置 页 面 如 图 14-11 所 示 。 


Wm Project Structure 
SDK Location 


Project Android SDK location: 


The directory where the Android SDK is located. This location will be used 

for new projects, and for existing projects that do not have a 

Ads local.properties file With a sdk. dir property. 

Authentic. .. 

Notificat. .. 
Nodules 


Develop. 





[D: \adt-bundle-vindovs-x86_64-20140702\sdk 


a JDK location: 
ae | The directory where the Java Developaent Kit (JDE) is located. 
Sapp 
eurton Use enbedded JDK (recomended) 
device 
event 


st Android NDK location: 

ee The directory vhere the Android NDK is located. This location will be saved 
si as ndk. dir property in the local.properties file. 

Rniddle 加 


[D:\Progron Files\Android\Androld Studio3\jre | 可] 


i D:\Android\android-ndk-r17 ~] 


Rnetyork 








LIE 


图 14-11 项 目 结构 页 面 设置 NDK 的 安装 路 径 





上 面 的 三 个 步骤 搭建 好 了 NDK 环境 ， 接 下 来 还 要 给 模块 添加 JNI 支持 ， 步 骤 说 明 如 下 : 


ER 


在 模块 的 src/main 路 径 下 创建 名 为 jni 的 目录 ，h 文件 、c 文件 、cpp 文件 、mk 编译 


文件 都 放 在 该 目录 下 。jni 目录 的 结构 如 图 14-12 所 示 ， 可 以 看 到 jni 与 java、res 等 目录 平 级 。 


ER 
所 示 。 





一 一 


名 称 修改 日 期 类 型 

县 java 2018/4/27 17:14 文件 夹 
Bb jni 2018/4/27 17:28 文件 来 
Bres 2018/4/27 17:14 文件 来 
目 a&ndroidlanifest. xnl 2018/4/27 17:14 XIL 文件 





14-12 jni 目录 在 模块 工程 中 的 位 置 
6 模块 名 称 ， 在 右键 菜单 中 选择 Link C++ Project with Gradle, 菜单 界面 如 图 14-13 





右 
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s juni or 
iddle 
了 aixzture 
3 senior UE 


xstorage sopy 
test Copy Path Ctrl+Shift+C 


Seradle Scri Copy as Plain Text 
Hbuild. er MPaste Ctrl+V 


Link C++ Project with Gradle 


Ctrl+X 


Ctrl+C 





图 14-13 在 右键 菜单 中 选择 C++ 支持 


G03 选中 C++ 支 持 菜单 后 , 弹出 一 个 配置 页 面 如 图 14-14 所 示 ， 在 Build System 一 栏 下 拉 
选择 ndk-build 表示 采用 Android Studio 内 置 的 编译 工具 . 在 Project Path 一 栏 选择 mk 文件 的 路 径 ， 
窗口 下 方 就 会 出 现 提 示 会 把 “src/main/jni/Android.mk” 保 存 到 build.gradle 中 。 

“二 Link C++ Project vithi cradie M20 [2 
Build System 


Select the main .mk file of the NDK project (e.g， Android.mk) 
Project Path jects\HelloWorld\nixture\src\nain\jni\Android. mk |[ -| 


Path to be saved into the build. gradle file: 


“src/nain/jni/Android. mk” 
| or | Cancel | Help 


14-14 给 模块 配置 ndk 编译 工具 与 mk 文件 


人 04 单 击 弹 窗 上 的 OK 按钮 ， 再 打开 该 模块 的 编译 配置 文件 build.gradle， 发 现在 android 
节点 下 果然 增加 了 externalNativeBuild 节点 ， 用 来 说 明 C++ 代码 的 编译 mk 文件 。 


/Android Studio 2.2 之 后 才 引 入 externalNativeBuild。 此 处 指定 mk 文件 的 路 径 
externalNativeBuild { 









































ndkBuild { 
// 下 面 是 编译 cpu 信息 、 加 解密 、 获 取 主 机 名 专用 的 mk 文件 
path "src/main/ini/Android.mk" 

: 


) 
CT05 正常 情况 上 一 步骤 单 击 OK 按钮 就 会 触发 编译 操作 ， 开 发 者 也 可 手动 选择 菜单 Build 
一 Make Module ***， 执 行 C/C++ 代 码 的 编译 工作 。 编 译 通 过 后 ， 可 在 “模块 名 称 
\build\intermediates\ndkBuild\debug\obj\local\armeabi” 路 径 下 找到 生成 的 so 库 文 件 。 
G06 在 stc/main 路 径 下 创建 so 库 的 保存 目录 ,目录 名 称 为 jniLibs, 并 将 生成 的 so 文件 复 
制 到 该 目录 下 。 复 制 完 so 库 的 目录 结构 如 图 14-15 所 示 ， 可 见 jniLibs 与 jni 目录 平 级 。 
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™ Mairture 
manifests 


> 
> java 
» Ml cpp 
T WjniLibs 
™ Marneabi 
libjni_mix.so 
T Marneabi-vTa 
Plibjni_mix.so 
> eres 





图 14-15 jniLibs 目录 在 模块 工程 中 的 位 置 
C07 重新 运行 App 或 重新 生成 签名 Apk， 最 后 产生 的 App 就 是 封装 好 so 库 的 版 本 。 


14.2.2 ”创建 JNI 接口 


JNI 是 Java Native Interface 的 缩写 ， 提 供 了 若干 API 实现 Java 和 其 他 语言 的 通信 (主要 
是 C/C++) 。 虽 然 JNI 是 Java 平台 的 标准 ， 但 是 要 想 在 Android 上 使 用 JNI， 还 得 配合 NDK 
才 行 ,NDK 提供 了 C/C++ 标 准 库 的 头 文件 和 标准 库 的 动态 链接 文件 (主要 是 .a 文 件 和 .so 文件 )。 
而 JNI 开 发 只 是 在 App 工程 下 编写 C/C++ 代码 ， 代 码 中 包含 NDK 提供 的 头 文件 ，build.gradle 
和 mk 文件 依据 编译 规则 把 标准 库 链接 进去 ， 编 译 通 过 后 形成 最 终 的 so 动态 库 文 件 ， 这 样 才 
能 在 App 中 通过 Java 代码 调用 JNI 接 口 。 

下 面 是 JNI 开发 的 具体 步骤 。 

人 ETID1 确保 NDK 环境 措 建 完成 ， 并 且 本 模块 已 经 添加 了 对 NDK 的 支持 。 

9702 在 要 调用 JNI 接口 的 Activity 代码 中 添加 JNI 接口 定义 , 并 在 初始 化 时 加 载 JNI 动态 
库 ， 具 体 代码 举例 如 下 : 


// 声明 cpuFromJNI 是 来 自 于 JNI 的 原生 方法 
public native String cpuFromJNI(int il, float f1, double d1, boolean b1); 














/ 在 加 载 当前 类 时 就 去 加 载 jni_mix.so， 加 载 动作 发 生 在 页 面 启动 之 前 
static { 
System.loadLibrary("jni_mix"); 
六 
C03 转 到 工程 的 jni 目录 下 ， 在 h 文件 、c 文件 、cpp 文件 中 编写 CC++ 代 码 。 注 意 C 代 
码 中 对 接口 名 称 的 命名 规则 是 “Java_ 包 名 _Activity 类 名 _ 函数 名 ”。 其 中 ， 包 名 中 的 点 号 要 替换 为 
下 划 线 。 下 面 是 C 代码 对 接口 名 称 命名 的 代码 : 
jstring Java_com example_mixture_JniCpuActivity_cpuFromJNI( JNIEnv* env, jobject thiz, jint i1, jfloat 全， 
jdouble d1, jboolean bl ) 
04 在 jni 目录 创建 一 个 mk 文件 单独 定义 编译 规则 ， 并 在 build.gradle 中 启 
extemalNativeBuild 节点 ， 指 定 mk 文件 的 路 径 。 
C05 编译 JNI 代码 ， 并 把 编译 生成 的 so 库 复 制 到 jniLibs 目录 ， 再 重新 运行 App。 
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以 上 开发 步 又 尚 有 3 处 需要 补充 描述 ， 分 别 是 数据 类 型 转换 、 编 译 规则 定义 以 及 开发 注 
意 事项 ， 详 细 说 明 如 下 。 


1. 数据 类 型 转换 


JNI 作为 Java 与 C/C++ 之 间 的 联系 桥梁 , 需要 对 基本 数据 类 型 进行 转换 , 基本 数据 类 型 的 
转换 关系 见 表 14-2。 








表 14-2 基本 数据 类 型 的 转换 关系 





























数据 类 型 名 称 Java 的 数据 类 型 JNI 的 数据 类 型 C/C++ 的 数据 类 型 
整 型 | Int jint | int 

浮 点 数 | Float jfloat | foat 

双 精 度 | double jdouble | double 

布尔 型 boolean jboolean unsigned char 








其 中 ， 整 型 、 浮 点 数 、 双 精度 3 种 数据 类 型 可 以 由 C/C++ 直接 使 用 ， 而 布尔 型 和 字符 串 
需要 处 理 后 才能 由 C/C++ 使 用 ， 具 体 的 处 理 规则 如 下 : 
(1) 处 理 布尔 类 型 时 ，Java 的 false 对 应 C/C++ 的 0，Java 的 true 对 应 C/C++ 的 1。 
(2) 处 理 字 符 串 类 型 时 ，JNI 使 用 env 一 GetStringUTFChars 方法 将 jstring 类 型 转 为 const 
char* 类 型 ， 使 用 env 一 NewStringUTF 方法 将 const char* 类 型 转 为 jstring 类 型 。 
2. 编译 规则 定义 


Android Studio 从 2.3 开始 ， 只 支持 外 部 配置 方式 编译 so 库 ， 也 就 是 需要 开发 者 另外 书写 
Android.mk 定义 编译 规则 。 编 译 规则 名 称 的 对 应 关系 见 表 14-3 。 





const char* 


表 14-3 ”编译 规则 名 称 的 对 应 关系 




















Android.mk 的 规则 名 称 
LOCAL MODULE so 库 文件 的 名 称 
LOCAL SRC FILES 需要 编译 的 源 文件 
LOCAL CPPFLAGS C++ 的 编译 标志 -fexceptions (支持 try..catch..) 
LOCAL LDLIBS 需要 链接 的 库 ， 多 个 库 用 逗号 分 | log (支持 打印 日 志 ) 
隔 
LOCAL WHOLE_STATIC_LIBRARIES | 要 加 载 的 静态 库 android_support 





下 面 是 一 个 Android.mk 内 部 编译 规则 的 例子 : 
LOCAL PATH := $(call my-dir) 
include $(CLEAR_VARS) 


# 指定 so 库 文件 的 名 称 
LOCAL MODULE :=jni mix 


第 14 章 融合 技术 | 663 





# 指定 需要 编译 的 源 文件 列表 

LOCAL SRC FILES := find name.cpp get_cpu.cpp get_encrypt.cpp get_ decrypt.cpp aes.cpp 
# 指定 C++ 的 编译 标志 

LOCAL CPPFLAGS += -fexceptions 

# 指定 要 加 载 的 静态 库 

LOCAL WHOLE STATIC LIBRARIES += android_support 

# 指定 需要 链接 的 库 

LOCAL LDLIBS =-llog 


include $(BUILD SHARED LIBRARY) 
S$(call import-module, android/support) 


写 好 了 Android.mk， 再 来 修改 build.gradle， 这 个 编译 文件 得 改 三 处 地 方 ， 分 别 是 两 处 
externalNativeBuild 加 一 处 packagingOptions， 具 体 的 编译 配置 修改 说 明 如 下 。 


android { 
compileSdkVersion 27 
buildToolsVersion "27.0.3" 


defaultConfig { 
applicationId "com.example.mixture" 
minSdkVersion 16 
targetSdk Version 27 
VersionCode 1 
VersionName "1.0" 


/ 此 处 说 明 mk 文件 未 能 指定 的 编译 参数 
externalNativeBuild { 
ndkBuild { 

/ 说 明 需 要 生成 哪些 处 理 器 的 so 文件 
// NDK 的 rl17 版 本 开始 不 再 支持 ARM5(armeabi)、MIPS、MIPS64 这 几 种 so 编译 
abiFilters "armeabi-v7a" 
/ 指定 C++ 编译 器 的 版 本 ， 比 如 下 面 这 行 用 的 是 CH+11 
//cppFlags "-std=c++11" 


// 下 面 指定 拾取 的 第 一 个 so 库 路 径 ， 编 译 时 才 不 会 重复 链接 
packagingOptions { 

pickFirst "lib/armeabi/libjni_mix.so' 

pickFirst "lib/armeabi-v7a/libjni_mix.so' 

pickFirst "lib/armeabi/libvudroid.so' 

pickFirst "lib/armeabi-v7a/libvudroid.so' 
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// Android Studio 2.2 之 后 才 引 入 externalNativeBuild。 此 处 指定 mk 文件 的 路 径 
externalNativeBuild { 
ndkBuild { 
// 下 面 是 编译 CPU 信息 、 加 解密 、 获 取 主 机 名 专用 的 mk 文件 
path "src/main/ini/Android.mk" 
//path file("sre\main\jni\Android.mk") 


E 
3. 开发 注意 事项 


由 于 JNI 接口 使 用 另 一 种 语言 开发 ， 因 此 要 注意 克服 Java 单独 编码 或 C/C++ 单独 编码 的 





(1) C/C++ 代码 中 的 变量 都 要 初始 化 ， 因 为 在 真 机 上 如 果 不 初始 化 ， 值 就 不 可 预知 ， 进 


而 影响 业务 逻辑 处 理 。 


(2) 由 于 JNI 的 接口 名 称 包 含 包 名 、 类 名 和 函数 名 ， 因 此 务必 保证 该 名 称 所 表达 的 路 径 


与 Java 代码 完全 一 致 ， 才 能 由 Java 代码 正常 调用 JNI 接口 。 


(3) JNI 中 操作 socket 要 设置 上 网 权限 ， 和 否则 socket 函数 总 是 返回 -1; 以 此 类 推 ，JNI 


中 操作 SD 卡 文件 存 取 也 要 设置 SD 卡 权 限 。 


接 下 来 通过 一 个 获取 CPU 指令 集 的 例子 演示 一 下 JNI 开发 的 完整 流程 和 基本 数据 类 型 的 


转换 。 下 面 是 JNI 代码 文件 get_cpu.cpp 的 源 代码 : 


#include <jni.h> 
#include <string.h> 
#include <stdio.h> 


extern "C" 


jstring Java_com_ example_mixture_JniCpuActivity_cpuFromJNI( JNIEnv* env, jobject thiz, jint il, jfloat fl, 


jdouble dl, jboolean bl ) { 
#if defined(_ arm ) 
#if defined( ARM ARCH 7A ) 
#if defined( ARM NEON_) 
#if defined( ARM_PCS_VFP) 
#define ABI "armeabi-v7a/NEON (hard-float)" 
#else 
#define ABI "armeabi-vV7a/NEON" 
#endif 
#else 
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#if defined( ARM PCS VFP) 
#define ABI "armeabi-v7a (hard-float)" 
#else 
#define ABI "armeabi-v7a" 
#endif 
#endif 
#else 
#define ABI "armeabi" 
#endif 
#elif defined( _ i386 ) 
#define ABI "x86" 
#elif defined( x86 64 ) 
#define ABI "x86 64" 
#elif defined(_ mips64) /* mips64el-* toolchain defines mips too*/ 
#define ABI "mips64" 
#elif defined(_ mips_) 
#define ABI "mips" 
#elif defined( aarch64 ) 
#define ABI "arm64-v8a" 
#else 
#define ABI "unknown" 
#endif 
char desc[200] = {0}; 
sprintf(desc, "%d %f %lf %u nHello from JNI! Compiled with %s.",il, fl,dl,bl,ABD; 
return env->NewStringUTF(desc); 


} 
下 面 是 活动 页 面 的 Java 代码 , 先 从 Build 类 获取 当前 的 指令 集 , 再 调用 JNI 接口 获取 C++ 
代码 得 到 的 指令 集 : 


public class JniCpuActivity extends AppCompatActivity implements OnClickListener { 
private TextView tv_cpu_jni; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_jni_cpu); 
TextView tv_cpu_build = findViewBylId(R.id.ty_cpu_build); 
tv_cpu_build.setText("Build 类 获得 的 CPU 指令 集 为 "+ Build.CPU_ABD; 
tv_cpu_jni= fmndViewById(R.id.tv_cpu_jnD; 
findViewById(R.id.btn_cpu).setOnClickListener(this); 


(@Override 
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public void onClick(View v) { 
if (v.getIdO) 一 R.id.btn_cpu) { 
// 调用 JNI 方法 cpuFromJNI 获得 CPU 信息 
String desc = cpuFromJNI(1, 0.5f, 99.9, true); 
tv_cpu_jni.setText(desc); 


/ 声明 cpuFromJNI 是 来 自 于 JNI 的 原生 方法 
public native String cpuFromJNI(int il, float f1, double d1, boolean b1); 


/ 在 加 载 当前 类 时 就 去 加 载 jni_mix.so， 加 载 动作 发 生 在 页 面 启动 之 前 
static { 
System.loadLibrary("jni_mix"); 
上 
JNI 接口 获取 指令 集 的 结果 如 图 14-16 和 图 14-17 所 示 。 如 图 14-16 所 示 为 模拟 器 上 的 运 
行 结果 截图 。 如 图 14-17 所 示 为 真 机 上 的 运行 结果 截图 。 


mixture mixture 


Build 类 获得 的 CPU 指 令 集 为 x86 Build 类 获得 的 CPU 指令 集 为 armeabi-v7a 


调用 JNI 接 口 获取 指令 集 调用 JNI 接 口 获取 指令 集 


1 0.500000 99.900000 1 1 0.500000 99.900000 1 
Hello from JNI! Compiled with armeabi-v7a. Hello from JNI! Compiled with armeabi-v7a. 





图 14-16 模拟 器 获得 的 指令 集 图 14-17 真 机 获得 的 指令 集 
14.2.3 ”JNI 实现 加 解密 
实际 开发 中 ，JNI 主要 应 用 于 如 下 业务 场景 : 
1. 对 关键 业务 数据 进行 加 解密 


虽然 Java 提供 了 常用 的 加 解密 方法 , 但 是 Java 代码 容易 遭 到 破解 , 而 so 库 到 目前 为 止 是 
不 可 破解 的 ， 所 以 使 用 JNI 进行 加 解密 无 疑 更 加 安全 。 


2. 底层 的 网 络 操作 与 设备 操作 


Java 作为 一 门 高 级 语言 ， 与 硬件 和 网 络 操作 的 隔 头 比 C/C++ 大 ， 不 像 C/C++ 那样 容易 驾 
驭 底层 操作 。 


3. 对 运行 效率 要 求 较 高 的 场合 
同样 的 操作 , C/C++ 的 执行 效率 比 Java 高 得 多 ,iOS 基于 C/C++ 的 变种 ObjectC , 而 Android 
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基于 Java, 所 以 ioS 的 流畅 性 强 于 Android。Android 上 的 SQLite 使 用 Java 实现 ， 因 此 性 能 存 
在 瓶颈 。 现 在 移动 端 兴起 了 第 三 方 的 数据 库 Realm， 性 能 优异 渐 有 取代 SQLite 之 势 , 而 Realm 
的 底层 是 用 C/C++ 实现 的 。 

另外 ， 如 图 像 处理 、 视 频 处 理 等 需要 大 量 运 算 的 场合 ， 其 底层 算法 也 都 是 用 C/C++ 完成 
的 ， 比 方 说 常见 的 位 图 工厂 类 BitmapFactory， 它 从 各 种 来 源 解析 位 图 数据 ,最 后 都 得 调用 JNI 
方法 。 还 有 嵌入 式 系统 的 三 维 图 形 接 口 库 OpenGL ES、 跨 平台 计算 机 视觉 库 OpenCV 等 著名 
的 图 形 开放 库 ， 它 们 的 底层 算法 统统 是 C/C++ 编程 实现 的 。 


4. 跨 平台 的 应 用 移植 


移动 设备 的 操作 系统 不 是 Android 就 是 iDOS， 现 在 企业 开发 App 一 般 都 要 做 两 条 产品 线 ， 
-条 做 Android， 另 一 条 做 iOS， 同 样 的 功能 需要 两 边 分 别 实现 ， 费 时 费力 。 如 果 部 分 业务 功 
E 采 用 C/C++ 实现 ， 那 么 不 但 Android 可 以 通过 JNI 调用 ,而且 iOS 能 直接 编译 运行 ,一 份 代 
码 可 同时 被 两 个 平台 复 用 ， 省 时 省 力 。 
接 下 来 我 们 尝试 使 用 JNI 完成 加 解密 操作 。C/C++ 的 加 解密 算法 代码 不 少 ， 本 书 采 用 的 是 
C++ 的 AES 算法 开源 代码 ， 主 要 的 改造 工作 是 给 C++ 源 代码 配 上 JNI 接口 。 
下 面 是 JNI 接口 的 AES 加 密 代码 : 
#include <jni.h> 
#include <string.h> 
#include <stdio.h> 
#include "aes.h" 
#include <android/log.h> 
/log 标签 
#define TAG "MyMsg" 
// 定义 info 信息 
#define LOGI(...) _ android_log_print(ANDROID LOG INFO,TAG, VA ARGS ) 





extern "C" 


jstring Java_com example_mixture_JniSecretActivity_encryptFromJNI( JNIEnv* env, jobject thiz, jstring 

raw, jstring key) { 
const char* str_raw; 
const char* str_key; 
str_raw = env->GetStringUTFChars(raw, 0); 
str_key = env->GetStringUTFChars(key, 0); 
LOGI("str raw=%s, str_ key=%s ", str_raw, str_key); 
char encrypt[1024] = {0}:; 
AES aes_en((unsigned char*)str key); 
aes_en.Cipher((char* )str_raw, encrypt); 
LOGI("encrypt=%s", encrypt); 
return env->NewStringUTF(encrypt); 
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下 面 是 JNI 接口 的 AES 解密 代码 : 


#include <jnih> 

#include <string.h> 

#include <stdio.h> 

#include "aes.h" 

#include <android/log.h> 

/log 标签 

#define TAG "MyMsg" 

// 定义 info 信息 

#define LOGI(...) _ android log print(ANDROID LOG INFO,TAG VA ARGS ) 


extern "Cn 


jstring Java_com_example_ mixture_JniSecretActivity_decryptFromJNI( JNIEnv* env, jobject thiz, jstring des, 
jstring key) { 

const char* str_des; 
const char* str_key; 
str_des = env->GetStringUTFChars(des, 0); 
str_key = env->GetStringUTFChars(key, 0); 
LOGI("str_des=%s, str_ key=%s ", str_des, str_key); 
char decrypt[1024] = {0}; 
AES aes_de((unsigned char*)str_key); 
aes_de.InvCipher((char*)str_des, decrypb; 
LOGI("decrypt=%s", decrypt); 
return env->NewStringUTF(decryp?t); 

} 


下 面 是 活动 页 面 的 Java 代码 ， 通 过 界面 对 输入 数据 进行 加 解密 操作 : 


public class JniSecretActivity extends AppCompatActivity implements OnClickListener { 
private EditText et_origin; / 声明 一 个 用 于 输入 原始 字符 串 的 编辑 框 对 象 
private EditText et_encrypt // 声明 一 个 用 于 输入 加 密 字 符 串 的 编辑 框 对 象 
private TextView tv_decrypt; 
private String mKey = "123456789abcdef"; // 该 算法 要 求 密 钥 串 的 长 度 为 16 位 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_jni_secret); 
et_origin = fndViewById(R.id.et_origin); 
et_encrypt = findViewBylId(R.id.et_encrypt); 
tv_decrypt = findViewById(R.id.tv_decrypt); 
findViewById(R.id.btn_encrypt).setOnClickListener(this); 
findViewByld(R.id.btn_decrypt).setOnClickListener(this); 
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@Override 
public void onClick(View v) { 
让 (v.getId() 一 R.id.btn_encrypt) { // 点 击 了 加 密 按钮 
// 调用 JNI 方法 encryptFromJNI 获得 加 密 后 的 字符 串 
String des =encryptFromJNI(et_origin.getText().toString(), mKey); 
et_encrypt.setText(des); 
}else if (v.getId() 一 R.id.btn_decrypt) { // 点 击 了 解密 按钮 
// 调用 JNI 方法 decryptFromJNI 获得 解密 后 的 字符 串 
String raw = decryptFromJNI(et_encrypt.getText().toString(), mKey); 
tv_decrypt.setText(raw); 


) 


// 声明 encryptFromJNI 是 来 自 于 JNI 的 原生 方法 
public native String encryptFromJNI(String raw, String key); 


// 声明 decryptFromJNI 是 来 自 于 JNI 的 原生 方法 
public native String decryptFromJNI(String des, String key); 


// 在 加 载 当前 类 时 就 去 加 载 jni_mix.so， 加 载 动作 发 生 在 页 面 启动 之 前 
static { 
System.loadLibrary("jni_mix"); 
b 
} 


JNI 实现 加 解密 的 效果 如 图 14-18 和 图 14-19 所 示 。 如 图 14-18 所 示 为 输入 原始 字符 串 并 调 
用 JNI 接 口 进 行 加 密 的 结果 界面 。 如 图 14-19 所 示 为 对 加 密 串 进行 JNI 解密 操作 的 结果 界面 。 











ABC888| ABC888 
调用 JNI 接 口 获取 加 密 串 调用 JNI 接 口 获取 加 密 串 
35E46A721F4483687547C9BE7D5262F0 35E46A721F4483687547C9BE7D5262F0 
调用 JNI 接 口 获取 解 密 趾 调用 JNI 接 口 获取 解 室 串 
ABC888 
14-18 JNI 的 加 密 结果 图 14-19 JNI 的 解密 结果 


14.3 “局域网 共享 


本 节 介 绍 融合 技术 的 一 个 重要 方向 








局 域 网 共享 ， 包 括 文件 在 内 的 手机 资源 都 有 可 能 
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利用 局 域 网 技术 分 享 给 其 他 设备 。 本 节 首先 说 明 如 何 使 用 无 线 网 络 管理 器 获取 当前 的 WiFi 信 
息 , 接着 描述 如 何 连接 无 线 网 络 和 开关 热点 ， 然 后 详细 阑 述 蓝牙 技术 的 4 个 工具 组 件 ， 以 及 如 
何 利用 蓝牙 技术 实现 两 台 设 备 之 问 的 消息 传递 。 


14.3.1 无 线 网 络 管理 器 WifiManager 


第 10 章 提 到 ，App 若 想 访问 外 网 资源 ， 得 先 判断 网 络 连接 是 否 可 用 。 当 时 检测 连接 的 工 
有 具 采用 了 连接 管理 器 ConnectivityManager， 上 网 方式 主要 有 两 种 ， 即 数据 连接 和 WiFi。 不 过 
ConnectivityManager 只 能 笼统 的 判断 能 否 上 网 ， 并 不 能 获知 WiFi 连接 的 详细 信息 。 当 前 网 络 
类 型 是 WiFi 时 ， 要 想 得 知 WiFi 上 网 的 具体 信息 ， 需 另外 通过 无 线 网 络 管理 器 WifiManager 
获取 。 

WifiManager 的 对 象 从 系统 服务 Context WIFI SERVICE 中 获取 。 下 面 是 WifiManager 的 
常用 方法 。 

e isWifiEnabled: 判断 WLAN 功能 是 否 开局。 

e setWifiEnabled: 开启 或 关闭 WLAN 功能 。 

。 getWifiState: 获取 当前 的 WiFi 连接 状态 。WiFi 连接 状态 的 取 值 说 明 见 表 14-4。 


表 14-4 ”WIFI 连 接 状 态 的 取 值 说 明 











WifiManager 类 的 连接 状态 说 明 

WIFL STATE_DISABLED 已 断 开 WiFi 
WIFL STATE_DISABLING 正在 断 开 WiFi 
WIFIL STATE_ENABLED 已 连 上 WiFi 
WIFI STATE_ENABLING 正在 连接 WiFi 
WIFI STATE_UNKNOWN 连接 状态 未 知 





e getConnectionInfo: 获取 当前 WiFi 的 连接 信息 。 该 方法 返回 一 个 WifiInfo 对 象 ， 通 过 
该 对 象 的 各 个 方法 可 获得 更 具体 的 WiFi 设备 信息 。 下 面 是 信息 获取 方法 说 明 。 
> getSSID: WiFi 路 由 器 MAC。 
> getRssi: WiFi 信号 强度 。 
> getLinkSpeed: 连接 速率 。 
> getNetworkId: WiFi 的 网 络 编号 。 
> getIpAddress: 手机 的 卫 地 址 。 整 型 数 ， 需 转换 为 常见 的 IPv4 地 址 。 
> getMacAddress: 手机 的 MAC 地 址 。 


startScan: 开始 扫描 周围 的 WiFi 信息 。 

getScanResults: 获取 WiFi 的 扫描 结果 。 

calculateSignalLevel: 根据 信号 强度 计算 信号 等 级 。 

getConfiguredNetworks: 获取 已 配置 的 网 络 信 息 。 

addNetwork: 添加 指定 的 WiFi 连接 。 

enableNetwork: 启用 指定 的 WiFi 连接 。 第 二 个 参数 表示 是 否 同时 禁用 其 他 WiFi。 
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e@ disableNetwork: 禁用 指定 的 WiFi 连接 。 


e@ disconnect: 断 开 当前 的 WiFi 连接 。 
查看 WiFi 连接 信息 的 实现 代码 很 简单 ， 读 者 可 自 “| 总 表 网 四 络 类型 是 Fl， 类 是 已 连接 。 
行 实践 。WiFi 信息 的 查看 效果 如 图 14-20 所 示 ， 主 要 | 路 由 汽 AC 是: 849 Obaf77 
包括 WiFi 路 由 器 的 相关 信息 、 手 机 在 该 WiFi 环境 下 | 渤 训 过 是 ; 54 |， 
分 配 到 的 IP 地 址 和 MAC 地 址 。 MAC 地 二 ac:38:70:50:b6:6a 
网 号 是 : 12 








14.3.2 ”连接 指定 WiFi 


图 14-20 真 机 获取 到 的 WiFi 信息 


上 一 小 节 提 到 getScanResults 方法 可 以 获得 WiFi 的 扫描 结果 ,那么 怎样 才能 连 上 某 个 WiFi 
并 上 网 冲浪 呢 ? 虽然 在 手机 的 系统 设置 菜单 里 很 容易 做 到 这 一 点 ,但 是 开发 者 还 是 有 必要 通过 
代码 验证 一 下 该 功能 。 要 连 上 某 个 具体 的 WiFi, 实际 开发 中 的 调用 顺序 为 : 首先 调用 startScan 
方法 开始 扫描 周围 WiFi， 然 后 调用 getScanResults 方法 获取 扫描 到 的 WiFi 列表 ， 接 着 通过 
getConfiguredNetworks 方法 查找 已 配置 的 网 络 信息 ; 如 果 找 到 指定 的 网 络 配置 ， 则 调用 
enableNetwork 方法 启用 该 WiFi; 如 果 没 找到 指定 WiFi 配置 ， 则 先 调用 addNetwork 方法 添加 
WiFi 配置 (该 方法 会 返回 一 个 网 络 ID 来 标识 刚 添加 的 WiFi) ， 然 后 调用 enableNetwork 方法 
启用 该 WiFi。 
需要 注意 的 是 ， 在 调用 addNetwork 方法 之 前 ， 还 得 创建 新 的 WiFi 配置 信息 ， 内 含 用 户 
名 、 密 码 、 加 密 类 型 等 信息 。 若 要 断 开 当前 的 WiFi 连接 ， 则 既 可 调用 disableNetwork 方法 ， 
也 可 调用 disconnect 方法 。 它 们 的 区 别 在 于 : disableNetwork 方法 不 但 断 开 连接 ， 并 且 此 后 也 
不 会 自动 重 连 ， 而 disconnect 方法 只 是 断 开 本 次 连接 ， 不 会 阻止 将 来 的 自动 重 连 。 
为 方便 理解 这 些 WiFi 方法 的 用 途 及 其 先后 次 序 关 系 ， 下 面 给 出 对 指定 WiFi 进行 连接 和 
断 开 的 操作 代码 片段 : 
if(isChecked){ / 连接 WiFi 
让 (client.networkId >= 0){ // 找到 已 保存 的 WiFi， 则 直接 连接 
/ 启用 指定 网 络 编号 的 WiFi 
mWifiManager.enableNetwork(client.networkld, true); 
} else { // 未 找到 已 保存 的 WiFi 
if(client.type 一 0) { // 该 WiFi 无 密码 ， 则 直接 添加 并 连接 
/ 创建 一 个 WiFi 配置 信息 
WifiConfiguration config = new WifiConfiguration(); 
config.SSID = "\"" + client.SSID + "\""; 
config.wepKeys[0] = ""; 
config.allowedKeyManagement.set(WifiConfiguration.KeyMgmt.NONE); 
config.wepTxKeyIndex = 0; 
// 往 无 线 网 络 管理 器 添加 新 的 WiFi 配置 ， 并 返回 该 WiFi 的 网 络 编号 
intnetId = mWifiManager.addNetwork(config); 
// 启用 指定 网 络 编号 的 WiFi 
mWifiManager.enableNetwork(netld, true); 
}else { // 该 WiFi 需 要 密码 ， 则 弹 窗 提示 用 户 输入 密码 


672 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


InputDialogFragment dialog = InputDialogFragment.newInstance( 
client.SSID, client.type, "请 输入 "+client.SSID+" 的 密码 "); 
String fragTag = mContext.getResources().getString(R.string.app_name); 
dialog.show(((Activity) mContext).getFragment Manager(), frag Tag); 
} 
}; 
}else { // 断 开 WiFi 
mWifiManager.disconnect(); / 断 开 当前 的 WiFi 连接 
| 


接着 看 看 WiFi 连接 的 结果 ， 具 体 如 图 14-21 和 图 14-22 所 示 ， 其 中 图 14-21 为 提示 用 户 
输入 WiFi 密码 的 对 话 框 界面 , 图 14-22 为 输 完 密码 成 功 连 接 之 后 的 WiFi 列表 界面 , 由 图 标 可 
见 已 经 连 上 名 为 “ChinaNet-yWXX” 的 WiFi 无 线 网 络 。 


mixture 


青 输 入 ChinaNet-yWXX 的 密码 @ 局 域 网 








5#1603 


GL ore 


图 14-21 弹 窗 提示 用 户 输入 WiFi 密码 图 14-22 ”密码 输入 正确 成 功 连接 WiFi 
14.3.3 ”开关 热点 





e setWifiApEnabled: 开启 或 关闭 WiFi 热点 。 隐 藏 方法 ， 需 通过 反射 调用 。 
。 getWifiApState: 获取 当前 的 WiFi 热点 状态 ，WiFi 热点 状态 的 取 值 说 明 见 表 14-5。 


表 14-5 “WiFi 热点 状态 的 取 值 说 明 
WifiManager 类 的 WIFI 热点 状态 说 明 
WIFL AP_STATE_DISABLED 
WIFL AP_STATE_DISABLING 
WIFL AP_STATE ENABLED 
WIFL AP_STATE_ENABLING 
WIFL AP_STATE_FAILED WiFi 热点 开启 失败 























ee isWifiApEnabled: 判断 WiFi 热点 是 否 启用 。 只 有 已 连接 状态 才 返 回 true， 其 余 都 返回 


false。 
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e getWifiApConfiguration: 获取 WiFi 热点 的 配置 信息 。 
e@ setWifiApConfiguration: 设置 WiFi 热点 的 配置 信息 。 


注意 到 上 面 与 WiFi 热点 有 关 的 方法 都 是 隐藏 方法 ， 这 意味 着 外 部 无 法 直接 调用 该 方法 。 
Android 因为 在 不 断 更 新 升级 ， 同 时 新 技术 也 是 层出不穷 ， 所 以 并 没有 把 所 有 的 公共 方法 开放 
出 来 。 查 看 Android 的 SDK 源码 ， 会 发 现 少数 公开 方法 加 上 了 hide 标记 ， 表 示 该 函数 是 隐藏 
方法 尚未 正式 开放 , 原因 可 能 是 不 稳定 或 者 有 待 完善 。 可 是 有 时 开发 者 又 确实 需要 调用 这 些 隐 
藏 方法 ， 这 得 通过 Java 的 反射 机 制 来 间接 实现 。 反 射 机 制 指 的 是 在 运行 过 程 中 ， 对 于 任意 一 
个 对 象 ， 程 序 能 够 调用 它 的 任意 公开 方法 和 属性 ， 而 不 被 hide 标记 所 束缚 。 
下 面 是 使 用 反射 机 制 实现 开关 WiFi 热点 的 代码 例子 : 
// 开关 WiFi 热 点 。 返 回 的 字符 串 为 空 则 表示 成 功 ， 非 空 则 表示 失败 〈 字 符 串 保存 失败 信息 ) 
public static String setWifiApEnabled(Wifi Manager wifiMgr, WifiConfiguration config, boolean enabled) { 
String desc = ""; 
if (config.SSID 一 null || config.SSID.length| <= 0) { 
desc= "热点 名 称 为 空 "; 
Teturn desc; 





ty { 
if (enabled) { 
// WiFi 和 热点 不 能 同时 打开 ， 所 以 打开 热点 的 时 候 需 要 关闭 WiFi 
wifiMgr.setWifiEnabled(false); 
|: 
/ 通过 反射 调用 设置 热点 
Method method = wifiMgr.getClass().getMethod("setWifiApEnabled", 
WifiConfiguration.class, Boolean.TYPE); 
// 返回 热点 打开 状态 
if (!((Boolean) method.invoke(wifiMgr config, enabled)) { 
desc= "热点 操作 失败 "; 
} catch (Exception e) { 
e.printStackTrace(); 
desc= "热点 操作 异常 : "+ e.getMessage(); 
b 
Teturn desc; 


} 


然后 观看 一 下 WiFi 热点 的 开启 效果 ， 通 过 如 图 14-23 所 示 的 测试 页 面 开启 手机 热点 ， 可 
见 当 前 的 热点 名 称 为 “DOOV V3”; 然后 打开 另 一 部 手机 的 系统 设置 菜单 ， 进 入 WLAN 页 面 
发 现 WiFi 列表 多 了 一 个 “DOOV V3”， 点 击 该 WiFi 即 可 进行 连接 ， 成 功 连 上 后 的 WiFi 列 
表 如 图 14-24 所 示 。 
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mixture 有 WLAN ) 
热点 名 称 : DOOV V3 已 连接 
SAEm:| | isomp0506 





已 保存 ， 通 过 WPA2 进行 保护 


加 密 方式 : 无 ~ 





14-23 ”A 手机 开启 WiFi 热点 图 14-24 B 手 机 发 现 WiFi 网 络 


不 过 要 注意 ， 上 述 代码 只 适用 于 Android 7.X 及 以 下 版 本 的 手机 ， 因 为 Android 从 8.0 开 

始 取 消 了 这 些 开关 热点 的 隐藏 函数 ， 普 通 应 用 不 再 允许 进行 热点 操作 了 。 不 过 Android 8.0 也 
提供 了 对 应 的 蔡 代 方案 ， 主 要 有 下 面 两 种 : 

(1) 系统 应 用 允许 访问 以 下 的 几 个 热点 方法 : WifiManager 的 setWifiApConfiguration 方 
法 (修改 热点 配置 ) 、ConnectivityManager 的 startTethering 方法 (开启 热点 ) 和 stopTethering 
方法 (关闭 热点 ) ， 由 于 这 三 个 方法 都 是 系统 方法 ， 因 此 只 有 系统 应 用 才 有 权限 调用 。 

(2) 普通 应 用 允许 访问 无 线 网 络 管理 器 WifiManager 的 startLocalOnlyHotspot 方法 和 
cancelLocalOnlyHotspotRequest 方法 来 开关 本 地 热点 ， 但 是 这 个 本 地 热点 无 法 访问 互联 网 ， 所 
以 仅 供 测试 没 喻 实际 用 途 。 


14.3.4 点 对 点 蓝牙 传输 








无 论 是 WiFi 还 是 4G 网 络 ， 建 立 网 络 连接 后 都 是 访问 互联 网 资源 ， 并 不 能 直接 访问 局 域 
网 资源 。 比 如 两 个 人 在 一 起 ，A 要 把 手机 上 的 视频 传 给 B， 通 常情 况 是 打开 手机 QQ， 通 过 
QQ 传送 文件 给 对 方 。 不 过 上 传 视 频 很 耗 流 量 ， 如 果 现 场 没有 可 用 的 WiFi, 手机 的 数据 流量 又 
不 足 ， 就 只 能 干 瞪眼 了 。 为 解决 这 种 邻近 传输 文件 的 问题 ， 蓝 牙 技 术 应 运 而 生 。 蓝 牙 技 术 是 一 
种 无 线 技术 标准 ， 可 实现 设备 之 间 的 短 距 离 数据 交换 。 

Android 为 蓝牙 技术 提供 了 4 个 工具 类 ， 分 别 是 蓝牙 适配器 BuletoothAdapter、 蓝 牙 设备 
BluetoothDevice 蓝牙 服务 端 套 接 字 BluetoothServerSocket 和 蓝牙 客户 端 套 接 字 BluetoothSocket。 


1. 蓝牙 适配器 BuletoothAdapter 


BuletoothAdapter 的 作用 其 实 跟 其 他 的 ***Manager 差不多 ， 可 以 把 它 当 作 蓝 牙 管 理 器 。 下 
面 是 BuletoothAdapter 的 常用 方法 说 明 。 


e getDefaultAdapter: 静态 方法 ， 获 取 默 认 的 蓝牙 适配器 对 象 。 

e。 enable: 打开 蓝牙 功能 。 该 方法 在 打开 蓝牙 时 不 会 弹出 提示 ， 所 以 一 般 不 这 么 调用 。 
更 常见 的 做 法 是 弹出 对 话 框 ， 提 示 用 户 是 否 允 许 外 部 发 现 本 设备 。 因 为 只 有 让 外 部 设 
备 发 现 本 设备 ， 才 能 够 进行 后 续 配 对 与 连接 操作 。 弹 窗 提示 用 户 打 开 蓝 牙 功能 的 代码 
如 下 : 

/ 弹出 是 否 允 许 扫描 蓝牙 设备 的 选择 对 话 框 
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Intent intent = new Intent(BluetoothAdapter. ACTION REQUEST DISCOVERABLE):; 
startActivityForResult(intent, mOpenCode); 


disable: 关闭 蓝牙 功能 。 

isEnabled: 判断 蓝牙 功能 是 否 打 开 。 已 打开 就 返回 true， 否 则 返回 false。 

startDiscovery: 开始 搜索 周围 的 蓝牙 设备 。 搜 索 结果 通过 广播 返回 。 

cancelDiscovery: 取消 搜索 操作 。 

isDiscovering: 判断 当前 是 否 正在 搜索 设备 。 

getBondedDevices: 获取 已 绑 定 的 设备 列表 。 该 方法 返回 的 是 已 绑 定 设备 的 历史 记录 ， 

而 非 当 前 能 够 连接 的 设备 。 

setName: 设置 本 机 的 蓝牙 名 称 。 

getName: 获取 本 机 的 蓝牙 名 称 。 

getAddress: 获取 本 机 的 蓝牙 地 址 。 

getRemoteDevice: 根据 蓝牙 地 址 获取 远程 的 蓝牙 设备 。 

getState: 获取 本 地 蓝牙 适配器 的 状态 。 值 为 BluetoothAdapter.STATE_ON 表示 蓝牙 可 

用 。 

elistenUsingRfeommWithServiceRecord : 根据 名 称 和 UUID 创建 并 返回 
BluetoothServerSocket。 

e listenUsingRfcommOn: 根据 渠道 编号 创建 并 返回 BluetoothServerSocket。 


2. 蓝牙 设备 BluetoothDevice 


BluetoothDevice 用 于 指 代 某 个 蓝牙 设备 ， 通 常 表 示 对 方 设备 。BuletoothAdapter 管理 的 是 
本 机 的 蓝牙 设备 。 下 面 是 BluetoothDevice 的 常用 方法 说 明 。 


e getName: 获得 该 设备 的 名 称 。 
e@ getAddress: 获得 该 设备 的 地 址 。 
e getBondState: 获得 该 设备 的 绑 定 状态 。 蓝 牙 设备 绑 定 状态 的 取 值 说 明 见 表 14-6。 


表 14-6 ”蓝牙 设备 绑 定 状态 的 取 值 说 明 








BluetoothDevice 类 的 绑 定 状态 说 明 

BOND_ NONE 未 绑 定 〈 未 配对 ) 
BOND_BONDING 正在 绑 定 (正在 配对 ) 
BOND_BONDING 已 绑 定 (已 配对 ) 


e@ createBond: 创建 配对 请 求 。 配 对 结果 通过 广播 返回 。 
@ createRfcommSocketToServiceRecord: 根据 UUID 创建 并 返回 一 个 BluetoothSocket。 
。 createRfcommSocket: 根据 渠道 编号 创建 并 返回 一 个 BluetoothSocket。 





3. 蓝牙 服务 端 套 接 字 BluetoothServerSocket 


BluetoothServerSocket 是 服务 端的 Socket， 用 来 接收 客户 端的 Socket 连接 请 求 。 下 面 是 常 
用 方法 说 明 。 
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e@ accept: 监听 外 部 的 蓝牙 连接 请 求 。 一 旦 有 请 求 接 入 ， 就 返回 一 个 BluetoothSocket 对 
象 。 

e@ close: 关闭 服务 端的 蓝牙 监听 。 

4. 蓝牙 客户 端 套 接 字 BluetoothSocket 

BluetoothSocket 是 客户 端的 Socket, 用 于 与 对 方 设备 进行 数据 通信 。 下 面 是 常用 方法 说 明 。 

connect: 建立 蓝牙 的 Socket 连接 。 

close: 关闭 蓝牙 的 Socket 连接 。 

getInptuStream: 获取 Socket 连接 的 输入 流 对 象 。 

getOutputStream: 获取 Socket 连接 的 输出 流 对 象 。 

getRemoteDevice: 获取 远程 设备 信息 ， 即 与 本 设备 建立 Socket 连接 的 远程 蓝牙 设备 。 
上 述 工 具 的 介绍 有 点 枯燥 乏味 ， 接 下 来 演示 使 用 蓝牙 建立 连接 、 发 送 消息 的 完整 流程 ， 

有 了 直观 印象 才能 进一步 理解 蓝牙 开发 的 具体 过 程 。 完 整流 程 主要 分 为 以 下 4 个 步骤 ; 


1. 开启 蓝牙 功能 


准备 两 部 手机 ， 各 自 安装 蓝牙 演示 App。 首 先 打 开演 示 App 的 蓝牙 页 面 ， 一 开始 两 部 手 
机 的 蓝牙 功能 均 为 关闭 ， 初 始 状态 的 页 面 效果 如 图 14-25 所 示 。 


mixture 





图 14-25 ”蓝牙 DEMO 工程 的 初始 页 面 
分 别 点 击 两 部 手机 左上 角 的 开关 按钮 ， 准 备 开 启 手 机 的 蓝牙 功能 。 两 部 手机 都 弹出 一 个 
确认 对 话 框 ， 提 示 用 户 是 否 允 许 其 他 设备 检测 到 本 手机 。 此 时 ，A 手机 的 授权 弹 窗 页 面 如 图 
14-26 所 示 ; B 手机 的 授权 弹 窗 页 面 如 图 14-27 所 示 。 


mixture 应 用 , 想 要 打开 蓝牙 , 以 便 其 他 设 
备 在 120 秒 内 可 检测 到 您 的 手机 。 





图 14-26 A 手机 的 授权 弹 窗 14-27 B 手机 的 授权 弹 窗 


当然 ， 都 要 点 击 “ 人 允许 ”按钮 确认 开启 蓝牙 功能 。 稍 等 一 会 儿 ， 两 部 手机 分 别 检测 到 了 
对 方 设备 的 存在 ， 把 对 方 设备 显示 在 页 面 上 ， 状 态 为 “未 绑 定 ”。 此 时 A 手机 的 页 面 信息 如 
图 14-28 所 示 ，B 手机 的 页 面 信息 如 图 14-29 所 示 。 
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CL ss 蓝牙 设备 搜索 完成 ls 正在 搜索 蓝牙 设备 
名 称 





名 称 地 址 状态 地 址 状态 
Lenovo A808t ”AC:38:70:3F:B6:6A ”未 绑 定 小 米 手机 64:CC:2E:77:53:5A ”未 绑 定 
图 14-28 A 手机 发 现 对 方 图 14-29 B 手 机 发 现 对 方 


2. 确认 配对 并 完成 绑 定 


在 任意 一 部 手机 上 点 击 对 方 设备 的 记录 ， 表 示 发 起 配对 请 求 。 两 部 手机 都 弹出 一 个 确认 
对 话 框 ， 提 示 用 户 是 否 将 本 机 与 对 方 设备 进行 配对 。 此 时 ，A 手机 的 配对 弹 窗 页 面 如 图 14-30 
所 示 ; B 手机 的 配对 弹 窗 页 面 如 图 14-31 所 示 。 

两 边 分 别 点 击 “ 配 对 ”按钮 ， 确 认 与 对 方 进行 配对 操作 。 配 对 完成 后 ， 蓝 牙 页 面 上 将 对 
方 设 备 的 状态 改 为 “已 绑 定 ”。 此 时 ，A 手机 的 页 面 信息 如 图 14-32 所 示 ，B 手机 的 页 面 信 息 
如 图 14-33 所 示 。 


蓝牙 配对 请 求 


设备 蓝牙 配对 请 求 
Lenovo A808t (B66A) 

配对 码 要 与 以 下 设备 配对 

707653 小手 机 


配对 之 后 , 所 配对 的 设备 将 可 以 在 建立 连接 清 确 保 其 明示 的 配对 密 四 为 
后 访问 您 的 通讯 录 和 通话 记录 。 707653 


取消 





图 14-30 A 手机 的 配对 弹 窗 图 14-31 B 手机 的 配对 弹 窗 


mixture mixture 


GL ss 正在 搜索 蓝牙 设备 @ 正在 搜索 蓝牙 设备 


名 称 地 址 状态 名 称 地 址 状态 
Lenovo A808t ”AC:38:70:3F:B6:6A 已 绑 定 64:CC:2E:77:53:5A ”已 绑 定 





图 14-32 A 手机 完成 配对 图 14-33 B 手机 完成 配对 
3. 建立 蓝牙 连接 


在 任意 一 部 手机 上 点 击 已 绑 定 的 设备 记录 ， 表 示 发 起 连接 请 求 。 具 体 地 说 ， 首 先是 客户 
端的 BluetoothSocket 调用 connect 方法 ， 然 后 服务 端 BluetoothServerSocket 的 accept 方法 接收 
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连接 请 求 ,于 是 双方 成 功 建立 连接 。 有 的 手机 可 能 会 弹 窗 提示 “应 用 *** 想 与 *** 设 备 进行 通信 ”， 
点 击 弹 窗 的 “确定 ”按钮 即 可 放行 。 建 立 连接 后 ， 设 备 记录 右边 的 状态 值 改 为 “已 连接 ”。 此 
时 ，A 手机 的 页 面 信息 如 图 14-34 所 示 ，B 手机 的 页 面 信息 如 图 14-35 所 示 。 


mixture mixture 


名 称 地 址 
Lenovo A808t AC:38:70:3F:B6:6A 已 连接 64:CC:2E:77:53:5A 已 连接 





图 14-34 A 手机 与 对 方 建立 连接 图 14-35 B 手机 与 对 方 建立 连接 
4. 通过 蓝牙 发 送 消息 
在 A 手机 上 点 击 已 连接 的 设备 记录 ， 表 示 想 要 发 送 消息 。 于 是 A 手机 弹出 文字 输入 对 话 
框 ， 提 示 用 户 输入 待 发 送 的 消息 文本 ， 文 字 输 入 框 效果 如 图 14-36 所 示 。 点 击 “确定 ”按钮 发 
送 消息 ，B 手机 接收 到 A 手机 发 来 的 消息 ， 就 把 该 消息 文本 通过 弹 窗 显示 出 来 ，B 手机 的 消 
息 弹 窗 效果 如 图 14-37 所 示 。 


真 高 兴 认 识 你 








图 14-36 A 手机 准备 向 对 方 发 送 消息 图 14-37 B 手 机 收 到 对 方 发 来 的 消息 


至 此 ， 一 个 完整 的 蓝牙 应 用 过 程 就 全 部 呈现 出 来 了 。 上 面 的 流程 仅 实现 了 简单 的 字符 串 
传输 ， 真 实 场景 更 需要 文件 传输 。 当 然 ， 使 用 输入 输出 流 操作 文件 也 不 是 什么 难事 。 

上 述 有 关 蓝 牙 设 备 的 搜索 与 配对 操作 ， 早 在 第 9 章 的 “9.5.3 ”蓝牙 BlueTooth” 已 经 做 了 
介绍 。 两 部 手机 之 间 通 过 蓝牙 分 享 ， 也 要 先进 行 搜索 、 配 对 操作 ,然后 才能 开展 后 续 的 连接 和 
数据 传输 操作 。 所 以 本 节 不 再 讲解 蓝牙 搜索 和 配对 的 详细 步骤 , 直接 进入 双方 设备 连接 和 数据 
传输 的 论述 环节 。 
正如 第 10 章 “10.4.2 Socket 通信 ”介绍 的 那样 ， 蓝 牙 Socket 同样 存在 服务 端 与 客户 端 
的 概念 ， 服 务 端 负责 侦 听 指定 端口 ,而 客户 端 只 管 往 该 端口 丢 数 据 。 因 此 作为 服务 端的 手机 要 
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先 开启 蓝牙 侦 听 线程 ， 时 刻 准备 守株待兔， 要 是 哪 只 兔子 正巧 跑 过 来 ， 就 能 与 之 交谈 了 。 下 面 
是 服务 端的 蓝牙 手机 处 理 侦 听 事务 的 任务 代码 示例 : 


/ 蓝牙 服务 端 开 启 侦 听 任务 ， 一 旦 有 客户 端 连 接 进 来 ， 就 返回 该 客户 端的 蓝牙 Socket 
public class BlueAcceptTask extends AsyncTask<Void, Void, BluetoothSocket> { 

private static final String NAME SECURE = "BluetoothChatSecure"; 

private static final String NAME INSECURE = "BluetoothChatInsecure"; 

private static BluetoothServerSocket mServerSocket; / 声明 一 个 蓝牙 服务 端 套 接 字 对 象 





public BlueAcceptTask(boolean secure) { 
BluetoothAdapter adapter = BluetoothA dapter.getDefaultAdapter(); 
/ 以 下 提供 了 三 种 侦 听 方法 ， 使 得 在 不 同情 况 下 都 能 获得 服务 端的 Socket 对 象 
try{ 
if (mServerSocket != null) { 
mServerSocket.close(); 
} 
f(secure) { // 安全 连接 
mServerSocket = adapter.listenUsingRfcomm WithServiceRecord( 
NAME SECURE, BluetoothConnector.uuid); 
} else { // 不 安全 连接 
mServerSocket = adapter.listenUsingInsecureRfcomm WithServiceRecord( 
NAME INSECURE, BluetoothConnector.uuid); 
' 
} catch (Exception e) { // 遇 到 异常 则 尝试 第 三 种 侦 听 方式 
e.printStackTrace(); 
mServerSocket = BluetoothUtil.listenServer(adapter); 


} 


// 线程 正在 后 台 处 理 
protected BluetoothSocket doInBackground(Void... params) { 
BluetoothSocket socket = null; 
while (true) { 
ty { 
// 如 果 accept 方 法 有 返回 ， 则 表示 某 部 设备 过 来 打招呼 了 
socket = mServerSocket.accept(); 
} catch (Exception e) { 
e.printStackTrace0; 
try { 
Thread.sleep(1000); 
} catch (InterruptedException el) { 
el.printStackTrace(); 
} 
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} 

证 (socket != null) { // Socket 非 空 ， 表 示 名 花 有 主 了 ， 赶 紧 带 去 见 公婆 
break; 

上 


} 
return socket; / 返回 侦 听 到 的 客户 端 Socket 实例 


1 


// 线程 已 经 完成 处 理 

protected void onPostExecute(BluetoothSocket socket) { 
/ 侦 听 结束 ， 通 知 监听 器 是 哪个 客户 端 Socket 连 了 进来 
mListener.onBlueAccept(socket); 


private BlueAcceptListener mListener; / 声明 一 个 蓝牙 侦 听 的 监听 器 对 象 
/ 提供 给 外 部 设置 蓝牙 侦 听 监听 器 
public void setBlueAcceptListener(BlueAcceptListener listener) { 

mListener = listener; 


) 


/ 定义 一 个 蓝牙 侦 听 的 监听 器 接口 ， 用 于 在 倾听 响应 之 后 回调 onBlueAccept 方法 
public interface BlueAcceptListener { 
void onBlueAccept(BluetoothSocket socket); 
bi 
} 


看 到 上 面 的 服务 端 已 经 准备 就 络 ， 此 刻 轮 到 客户 端 磨 刀 和 霍霍 了 。 首 先 客户 端 要 与 服务 端 
建立 连接 打通 信道 ， 核 心 是 调用 对 方 设备 对 象 的 createRfcommSocket 相关 方法 ， 从 而 获得 该 
设备 的 蓝牙 Socket 实例 。 建 立 蓝牙 连接 的 任务 代码 示例 如 下 : 


// 输入 对 方 设备 的 蓝牙 设备 对 象 BluetoothDevice， 输 出 该 设备 的 蓝牙 套 接 字 对 象 BluetoothSocket 
public class BlueConnectTask extends AsyncTask<BluetoothDevice, Void, BluetoothSocket> { 
private String mAddress; “// 对 方 蓝牙 设备 的 MAC 地 址 
public BlueConnectTask(String address) { 
mAddress = address; 


} 


// 线程 正在 后 台 处 理 
protected BluetoothSocket doInBackground(BluetoothDevice... params) { 
// 创建 一 个 对 方 设备 的 蓝牙 连接 器 ，params[0] 为 对 方 的 蓝牙 设备 对 象 BluetoothDevice 
BluetoothConnector connector = new BluetoothConnector(params[0], true, 
BluetoothA dapter.getDefaultAdapter(), nulD; 
BluetoothSocket socket = null; 
/ 蓝牙 连接 需要 完整 的 权限 ， 有 些 机 型 弹 窗 提示 "*** 想 进行 通信 "， 这 就 不 行 ， 日 志 会 报错 
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try{ 
/ 开始 连接 ， 并 返回 对 方 设 备 的 蓝牙 套 接 字 对 象 BluetoothSocket 
socket = connector.connect().getUnderlyingSocket(); 

} catch (Exception e) { 
e.printStackTrace(); 

} 

Teturn socket; / 返回 对 方 设备 的 蓝牙 套 接 字 实 例 


/ 线程 已 经 完成 处 理 

protected void onPostExecute(BluetoothSocket socket) { 
/ 连接 完成 ， 通 知 监听 器 该 地 址 已 具备 蓝牙 套 接 字 
mListener.onBlueConnect(mA ddress, socket); 


上 


private BlueConnectListener mListener; / 声明 一 个 蓝牙 连接 的 监听 器 对 象 
// 提供 给 外 部 设置 蓝牙 连接 监听 器 
public void setBlueConnectListener(BlueConnectListener listeneD { 

mListener = listener; 


} 


// 定义 一 个 蓝牙 连接 的 监听 器 接口 ， 用 于 在 成 功 连接 之 后 调用 onBlueConnect 方法 
public interface BlueConnectListener { 
void onBlueConnect(String address, BluetoothSocket socket); 
双方 建立 连接 之 后 ， 客 户 端 拿 到 了 蓝牙 Socket 实例 ， 于 是 调用 getOutputStream 方法 获得 
输出 流 ， 然 后 即 可 进行 TO 交互 。 客 户 端 具体 的 发 送信 息 代 码 如 下 所 示 : 
// 向 对 方 设备 发 送信 息 
public static void writeOutputStream(BluetoothSocket socket, String message) { 
try 
OutputStream outStream = socketgetOutputStream(0; // 获得 蓝牙 Socket 对 象 的 输出 流 
outStream.write(message.getBytes0); / 往 输出 流 写 入 字 节 形式 的 数据 
} catch (Exception e) { 
e.printStackTrace(); 
b 
服务 端 当 然 也 没 闲 着 ， 早 在 双方 建立 连接 之 时 ， 便 早早 开启 了 消息 接收 线程 ， 随 时 准备 
倾听 客户 端的 呼声 。 该 线程 内 部 调用 蓝牙 Socket 实例 的 getInputStream 方法 获得 输入 流 , 接着 
从 输入 流 读 取 数 据 并 送 给 主线 程 处 理 。 详 细 的 接收 线程 处 理 代码 如 下 : 


/ 服务 端 开启 的 数据 接收 线程 
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public class BlueReceiveTask extends Thread { 
private BluetoothSocket mSocket; / 声明 一 个 蓝牙 套 接 字 对 象 
private Handler mHandler;，// 声明 一 个 处 理 器 对 象 


public BlueReceiveTask(BluetoothSocket socket Handler handler) { 
mSocket = socket; 
mHandler = handler; 


public void run() { 
byte[] buffer = new byte[1024]; 
int bytes; 
while (true) { 
ty { 
// 从 蓝牙 Socket 获得 输入 流 ， 并 从 中 读 取 输 入 数据 
bytes = mSocket.getInputStream().read(buffer); 
// 将 读 到 的 数据 通过 处 理 器 送 回 给 UI 主线 程 处 理 
mHandler.obtainMessage(0, bytes, -1, buffer).sendToTarget(); 
} catch (Exception e) { 
€.printStackTrace(); 
break; 


} 


此 时 回 到 蓝牙 主页 面 ， 也 就 是 UI 线程 得 到 消息 接收 线程 传 来 的 数据 ， 把 字 节 形式 的 数据 
转换 为 原始 的 字符 串 , 这 样 便 在 另 一 部 手机 上 看 到 发 出 来 的 消息 啦 。 下 面 是 主线 程 收 到 消息 后 
的 操作 代码 : 


// 收 到 消息 接收 线程 读 到 的 消息 
private Handler mHandler = new Handler() { 
/ 在 收 到 消息 时 触发 
public void handleMessage(Message msg) { 
if (msg.what =— 0) { 
byte[] readBuf = (byte[]) msg.obj; 
/ 把 字 节 数据 转换 为 字符 串 
String readMessage = new String(readBuf 0, msg.arg1); 
/ 弹出 收 到 消息 的 提醒 对 话 框 
AlertDialog.Builder builder =new AlertDialog.Builder(BluetoothTransActivity.this); 
builder.setTitle(" 我 收 到 消息 啦 ").setMessage(readMessage); 
builder.setPositiveButton(" 确 定 ", nul); 
builder.create().show(); 
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14.4 ”实战 项 目 : 共享 经 济 和 弄潮儿 一 一 WiFi 共享 器 


互联 网 之 所 以 成 为 新 经 济 ， 很 重要 的 一 个 原因 是 深入 贯彻 了 分 享 的 精髓 。 从 你 有 我 无 ， 
到 人 人 共享 , 这 是 人 类 历史 上 的 一 大 进步 。 本 章 介 绍 的 融合 相关 技术 从 一 起 显示 网 页 到 一 起 运 
行 代码 ,再 到 一 起 分 享 文件 ， 其 实 都 渗透 着 共享 的 思想 。 本 章 结尾 进一步 在 用 户 手 机 之 间 共 享 
网 络 ， 即 共享 流量 。 具 体 地 说 ， 就 是 一 个 手机 开启 WiFi 热点 ， 其 他 设备 均 可 接 入 该 WiFi 上 
网 冲浪 ， 这 就 是 本 章 的 实战 项 目 一 一 “WiFi 共享 器 ”。 


14.4.1 ”设计 思路 


每 逢 节假日 大 家 常常 呼 朋 唤 友 外 出 游玩 ， 可 是 因为 室外 WiFi 信号 很 弱 ， 要 么 干脆 找 不 到 
公共 WiFi 信号 ， 所 以 在 外 玩 豆 往 往 很 消耗 手机 流量 。 有 的 朋友 用 完了 流量 ， 有 的 朋友 还 剩 不 
少 流量 , 能 不 能 把 剩余 的 流量 给 别人 使 用 呢 ? 当然 可 以 。 现 在 不 少 手机 都 自 带 个 人 热点 /WLAN 
热点 /WiFi 热点 之 类 的 功能 ， 开 启 该 功能 即 可 将 手机 变 为 一 台 无 线路 由 器 ， 其 他 设备 连接 该 手 
机 的 热点 WiFi 后 上 网 就 不 会 耗费 自身 流量 ， 而 是 使 用 开启 热点 的 手机 的 数据 流量 。 

手机 的 WiFi 热点 功能 一 般 集成 在 系统 设置 中 ， 页 面 很 简单 ， 功 能 也 相对 简单 。 现 在 我 们 
给 热点 做 一 下 功能 增强 ， 实 现 名 副 其 实 的 WiFi 共享 器 ， 页 面 效 果 如 图 14-38 所 示 。 

光 看 这 个 页 面 ， 读 者 可 能 不 能 很 快 明白 采用 了 哪些 App 技术 ， 且 待 笔者 细 细 数 来 ， 看 看 
这 个 简单 的 页 面 究 竞 蕴含 哪些 江湖 绝技 。 

(1) 无 线 网 络 管理 器 WifiManager: 这 是 比较 明白 的 ， 开关 
热点 都 要 由 WifiManager 操 作 。 开关 WIFI @ 


(2) 系统 文件 读 取 : 在 系统 文件 /proc/net/arp 中 ， 可 找到 | wrtgg 称 : |cmavgpG6PRJJBl99 
已 连接 设备 列表 的 IP 和 MAC 地址 。 





WIFI 密码 : 
(3) 网 络 地 址 InetAddress: 判断 某 个 设备 能 否 连 上 , 用 到 
S 加 密 方式 ; 无 
了 InetAddress 的 isReachable 方法 。 
(4) 异步 任务 AsyncTask: 涉及 网 络 操作 都 要 把 处 理 逻 辑 
当前 已 有 2 人 台 设 备 连接 


放 在 子 线程 中 处 理 。 ns 
(5) 资产 管理 器 AssetManager: 用 于 导入 MAC 地 址 与 设 | eT 
备 厂 商 的 对 应 关系 表 。 因 为 联网 设备 的 MAC 由 国际 电子 协会 |。。 QUAN 192168432 Fa1654AlO430 
IEEE 统一 分 配 ， 未 经 认证 和 授权 的 厂家 无 权 生 产 ，MAC 地 址 
的 前 6 位 代表 手机 和 电脑 厂商 ， 所 以 可 通过 MAC 地 址 查询 对 ”图 1438 WiFi 共享 器 的 效果 图 
应 的 厂商 名 称 。MAC 与 厂商 的 对 应 关系 可 从 http://standards.ieee.org/regauth/oui/oui.txt 查询 。 
(6) 数据 库 SQLite: MAC 与 厂商 关系 表 要 导入 SQLite 数据 库 中 ， 方 便 后 续 查 询 操 作 。 
(7) 异步 服务 IntentService: 从 assets 目录 导入 MAC 与 厂商 关系 表 ， 由 于 比较 耗 时 ， 因 
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此 为 了 避免 页 面 挂 死 ， 必 须 开 启 后 台 服 务 执行 导入 操作 ， 而 且 开启 子 线程 的 异步 服务 。 
(8) 套 接 字 Socket: 使 用 Socket 技术 通过 NetBIOS 协议 获取 网 络 上 的 计算 机 名 称 。 
(9) JNI 开发 : C 语言 完成 NetBIOS 协议 的 信息 获取 需要 实现 JNI 接口 供 Java 代码 调用 。 


真是 不 数 不 知 道 ， 原 来 简 简 单单 的 页 面 背后 竞 隐 藏 了 这 么 多 不 为 人 知 的 高 招 ， 所 以 不 要 
小 看 App 开发 ， 做 好 一 项 功能 往往 需要 联合 使 用 多 种 技术 。 





14.4.2 ”小 知识 : NetBIOS 协议 


NetBIOS 协议 是 一 种 局 域 网 上 的 应 用 程序 编程 接口 ,为 程序 提供 了 请 求 低级 服务 的 统一 命 
令 集 , 允许 程序 和 网 络 会 话 ,在 Windows 操 作 系 统 中 ,安装 TCP/IP 协议 后 会 自动 安装 NetBIOS 。 
也 就 是 说 ，Windows 平台 自 带 NetBIOS 服务 。 

NetBIOS 提供 的 信息 包括 计算 机 名 称 、 工 作 组 名 和 域名 。 从 程序 角度 来 看 ， 只 要 一 个 IP 
地 址 用 的 是 Windows 操作 系统 ， 通 过 NetBIOS 协议 即 可 获得 该 IP 的 计算 机 名 和 MAC 地 址 ， 
为 开发 者 获知 对 方 的 设备 信息 提供 了 便利 。 

其 实 ， 通 过 Java 代码 就 能 根据 IP 地 址 获取 对 方 的 计算 机 名 ， 参 见 本 书 附带 源码 mixture 
模块 里 面 的 GetClientrName.java， 对 应 的 页 面 代 码 片段 如 下 : 


// 在 点 击 某 条 设备 记录 时 触发 
public void onItemClick(AdapterView<?> parent, View view, int position, long id) { 
final String ip = mClientArray.get(position).getIpAddr(); 
// 开启 分 线程 根据 IP 地 址 查找 该 设备 的 主机 名 称 
new ThreadO) { 
public void runO { 
/ 下 面 以 java 方式 获取 主机 名 
try{ 
GetClientName client = new GetClientName(ip); 
showDeviceName(client.getRemoteInfo()); 
} catch (Exception e) { 
€.printStack Trace(); 
1 
} 
}.start(); 
y 


// 显示 设备 的 主机 名 
Private void showDeviceName(String info) { 
if (!TextUtils.isEmpty(info)) { 
final String[] split = info.split(™\W\"); 
if (splitlength > 1 &é& split[1].length() > 0) { 
/ 回 到 UI 主线 程 来 操作 界面 
runOnUiThread(new Runnable() { 
@Override 
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public void run() { 
String desc = String.format("%s 的 计算 机 名 称 是 %s", split[0], split[1]); 
// 下 面 弹 出 提醒 对 话 框 展 示 找到 的 主机 名 
AlertDialog.Builder builder = new AlertDialog. Builder(NetbiosActivity.this); 
builder.setMessage(desc); 
builder.setPositiveButton(" 确 定 ", nulD); 
builder.create().showO); 


上 述 代码 查找 已 连接 设备 的 计算 机 名 称 ， 其 演示 界面 如 图 14-39 和 图 14-40 所 示 。 其 中 图 
14-34 展示 了 在 系统 文件 /proc/net/arp 里 面 找到 的 已 连接 设备 列表 , 点 击 某 条 设备 记录 , 则 立即 
开启 分 线程 获取 该 设备 的 主机 名 , 并 将 找到 的 主机 名 称 弹 窗 显示 , 提醒 弹 窗 的 对 话 框 效果 如 图 
14-40 所 示 。 


mixture 


请 先 开启 手机 上 的 WLAN 热 点 , 然后 笔记 本 电脑 
连接 这 个 热点 WIFI 
请 点 击 下 面 的 设备 列表 查看 计算 机 名 称 192.168.1.6 的 计算 机 名 称 是 


wlan0 81 168 192.168.1.1 D8:49:0B:FB:AF:71 OUYANGSHEN 


wlan0 192.168.1.6 F8:16:54:A1:C4:30 





192.168 
.1.6 


14-39 已 连接 设备 的 列表 记录 图 14-40 ”找到 某 设备 的 主机 名 称 


虽然 Java 已 能 实现 查找 计算 机 名 的 功能 ， 但 是 在 底层 操作 NetBIOS 怎么 少 得 了 威名 赫赫 
的 C 语言 呢 ? 正好 本 章 介绍 了 JNI 开发 ， 不 妨 使 用 C 语言 的 代码 实现 计算 机 名 的 获取 功能 。 
下 面 是 完整 的 JNI 代码 ， 读 者 可 尝试 将 其 集成 到 实战 项 目 中 : 

#include <jni.h> 

#include <string.h> 

#include <stdio.h> 

#include <stdlib.h> 

#include <string.h> 

#include <netdb.h> 

#include <sys/stat.h> 

#include <sys/types.h> 

#include <sys/select.h> 

#include <sys/socket.h> 

#include <netinet/in.h> 

#include <arpa/inet.h> 
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#define send MAXSIZE 50 

#define recv MAXSIZE 1024 

struct NETBIOSNS { 
unsigned short int tid; Wunsigned short int 占 2 字 节 
unsigned short int flags; 
unsigned short int questions; 
unsigned short int answerRRS; 
unsigned short int authorityRRS; 
unsigned short int additionalRRS; 
unsigned char name[34]; 
unsigned short int type; 
unsigned short int classe; 

}; 


char *getNameFromIp(const char *ip); 
extern "C" 


jstring Java_com _ example_mixture WifiShareActivity nameFromJNI( JNIEnv* env, jobject thiz, jstring ip) { 
const char* str_ip; 
str_ip = env->GetStringUTFChars(ip, 0); 
return env->NewStringUTF(getNameFromIp(str_ ip)); 


char *getNameFromIp(const char *ip) { 

char str_info[1024] = {0}; 

struct sockaddr in toAddr:; /在 sendto 中 使 用 的 对 方 地 址 

struct sockaddr_ in fromAddr; 。“// 在 recvfrom 中 使 用 的 对 方 主 机 地 址 

char send_bufffsend_ MAXSIZE]; 

char recv_buff[recv_ MAXSIZE]; 

memset(send_buff, 0, sizeof(send_buff)); 

memset(recv_buff, 0, sizeof(recv_buff)); 

int sockfd; //socket 

unsigned int udp_port = 137; 

int inetat; 

if ( (inetat = inet_aton(ip, &toAddr.sin addr))— 0) { 
Sprintfstr_ info, "[%s] is not a valid IP address\n", ip); 
Teturn str_info; 

h 

让 ( (sockfd = socket(AF INETSOCK DGRAM.,IPPROTO UDP))<0){ 
Sprintfstr_info, "%s socket error sockfd=%d, inetat=%d\n", ip, sockfd, inetat); 


return str_info; 
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bzero((char*)&toA ddr,sizeof(toA ddr)); 
toAddr.sin family =AF INET; 
toAddr.sin addrs addr = inet addr(ip); 
toAddr.sin port= htons(udp_port); 
// 构 造 NetBIOS 结构 包 
struct NETBIOSNS nbns; 
nbns.tid=0x0000; 
nbns.flags=0x0000; 
nbns.questions=0x0100; 
nbns.answerRRS=0x0000; 
nbns.authorityRRS=0x0000; 
nbns.additionalRRS=0x0000; 
nbns.name[0]=0x20; 
nbns.name[1]=0x43; 
nbns.name[2]=0x4b; 
int j=0; 
for (=3;j<34:j++) { 
nbns.name[j]=0x41; 
} 
nbns.name[33]=0x00; 
nbns.type=0x2100; 
nbns.classe=0x0100; 
memcepy(send_buff, &nbns, sizeof(nbns)); 
int send_num =0; 
send_num = sendto(sockfd, send_buff, sizeof(send_buf?f), 0, (struct sockaddr *)&toAddr, 
sizeof(toAddr) ); 
if (send_num != sizeof(send_buff)) { 
sprintflstr_info, "%s sendto() error sockfd=%d, send_num=%d, sizeoflsend_buff)=%d\n", ip, 
sockfd, send_num, sizeoflsend_buff)); 
shutdown(sockfd, 2); 
return str_info; 
} 
int recv_num = recvfrom(sockfd, recv_buff sizeof(recv_buf?f), 0, (struct sockaddr *)NULL, 
(socklen_t*)NULL); 
if (recv_num <56){ 
sprintf(str_info, "%s recvfrom() error sockfd=%d, recv_num=%d\n", ip, sockfd, recv_num); 
shutdown(sockfd, 2); 
Teturn str_info; 
} 
// 这 里 要 初始 化 。 因为 发 现 Linux 和 模拟 器 都 没 问题 , 真 机 上 该 变量 如 果 不 初始 化 , 值 就 不 可 预知 
unsigned short int NumberOfNames=0; 
memcpy(&NumberOfNames, recv_buff+56, 1); 
char str name[1024] = {0}; 
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unsigned short int mac[6]={0}; 


int i=0; 
for (i=0; i<NumberOfNames; 计 +) { 
char NetbiosName[16]; 
memcpy(NetbiosName,recv_bufft57+i*18, 16); /依次 读 取 NetBIOS name 
if 一 0){ 
sprintf(str_ name, "%s", NetbiosName); 
. 
} 


sprintf(str_info, "%s|%s|", ip, str_name); 
for (i=0; i<6; it+) { 
memcpy(&mac[i], recv_buff+57+NumberOfNames*18+i,1); 
Sprintfstr_ info, "%s%02X", str_info, mac[i]); 
if(is5){ 
sprintf(str_info, "%s-", str_info); 
b 
} 
return str_info; 


} 
14.4.3 ”代码 示例 


<!-- 查看 网 络 状态 -> 

<uses-permission android:name="android.permission.ACCESS_NETWORK STATE" /> 
<uses-permission android:name="android.permission.ACCESS_WIFI STATE" /> 

<!-- WLAN -> 

<uses-permission android:name="android.permission.ACCESS_WIFI STATE" /> 
<uses-permission android:name="android.permission.CHANGE WIFL STATE" /> 

<!-- 上 网 --> 

<uses-permission android:name="android.permission.INTERNET" /> 


(3) 在 AndroidManifestxml 中 注册 MAC 与 设备 的 关系 导入 服务 ， 注 册 代 码 如 下 : 
<service android:name=".service.ImportService" android:enabled="true" /> 


(4) 开关 WiFi 热点 ， 只 能 在 真 机 上 测试 ， 无 法 在 模拟 器 上 测试 ， 并 且 真 机 的 操作 系统 


不 能 高 于 Android 8.0， 因 为 8.0 之 后 不 再 允许 普通 应 用 开关 热点 。 
编码 完成 ， 照 例 观看 一 下 WiFi 热点 的 页 面 效 果 ， 一 开始 打开 热点 页 面 ， 热 点 状态 是 关闭 





的 ， 如 图 14-41 所 示 。 点 击 右 上 和 角 的 开关 按钮 ， 将 WiFi 热点 开启 ， 如 图 14-42 所 示 。 
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开关 WIFI 开关 WIFI @) 
WIFI 名 称 : CMAY9DG6PRJJBI99 WIFI 名 称 : CMAY9DG6PRJJBI99 
WIFI 密码 : WIFI 密码 : 
加 密 方式 : 无 加 密 方式 : 无 四 
保存 设置 保存 设置 
当前 没有 设备 连接 当前 没有 设备 连接 
图 14-41 ”WiFi 共享 器 的 初始 页 面 图 14-42 开启 WiFi 热点 功能 


这 个 WiFi 热 点 的 名 称 是 “CMAY9D***”, 打 
开 其 他 设备 〈 包 括 手 机 和 笔记 本 电脑 ) 刷新 WiFi 
列表 ， 然 后 点 击 连 接 新 发 现 的 WiFi 
“CMAY9D***”， 热 点 管理 页 面 就 会 将 该 设备 加 
入 已 连接 的 设备 列表 。 如 果 是 手机 连接 ， 设 备 名 这 
列 显示 的 就 是 手机 的 制造 厂商 ; 如 果 是 笔记 本 连 
接 ， 设 备 名 这 列 显示 的 就 是 该 电脑 上 登记 的 计算 机 
名 。 笔 者 测试 时 ， 热 点 管理 页 面 依次 找到 了 一 部 联 
想 手机 、 一 部 苹果 手机 、 一 部 小 米 手 机 ， 外 加 一 台 
计算 机 名 为 OUYANGSHEN 的 笔记 本 电脑 ， 如 图 
14-43 所 示 。 接 入 WiFi 的 设备 一 览 无 余 ， 再 也 不 用 
担心 自己 的 WiFi 被 路 了 。 

目前 ，WiFi 共享 器 主要 实现 了 3 个 功能 , 即 开 
关 热 点 、 修 改 热点 配置 和 查看 已 连接 设备 信息 。 读 
者 车 有 兴趣 ， 可 以 加 以 完善 ， 比 如 加 一 个 小 黑 屋 功 
能 ， 把 不 明 来 源 的 设备 加 入 黑 名 单 ， 不 让 它 连接 本 ”图 1443 检测 到 已 接 入 WiFi 热点 的 设备 列表 


~ 


WIFI 名 称 : CMAY9DG6PRJJBI99 
WIFI 密码 ; 

加 密 方式 : 无 学 
保存 设置 
当前 已 有 4 台 设 备 连 接 
品牌 设备 名 。 IP 地 址 MAC 地 址 
Lenovo 联想 。 192.168.43.39 503C:C41FA796 
Intel ”OUYAN 192.168.43.2 FB:16:54:A1:C4.30 


GSHEN 
Xiaomi 小 米 192.168.43.12 64:CC:2E:77:53:5B 





Apple 苹果 192.168.43.14 D0:33:11:3E:0C:76 





机 热点 ; 也 可 以 加 一 个 流量 控制 功能 , 一旦 检测 到 热点 流量 超过 阅 值 , 就 立即 关闭 WiFi 热点 ， 
避免 不 必要 的 流量 消耗 。 


下 面 简单 介绍 一 下 本 书 附带 源码 mixture 模块 中 ， 与 WiFi 共享 器 有 关 的 主要 代码 之 间 的 
关系 : 
(1) GetClientListTask.java: 这 是 获取 已 连接 设备 列表 的 分 线程 。 虽 然 读 取 系 统 文件 
/proc/net/arp 即 可 获得 近期 连接 的 设备 列表 ， 但 是 这 个 列表 文件 并 不 十 分 准确 ， 里 面 的 设备 很 
可 能 早已 断 开 连 接 。 为 了 保证 设备 列表 的 有 效 性 ， 还 得 进行 设备 能 和 否 连通 的 检测 ， 由 于 连通 性 
检查 需要 访问 网 络 , 因此 该 操作 必须 放 在 分 线程 中 异步 执行 。 设备 列表 获取 与 检测 的 分 线程 代 
码 如 下 : 
public class GetClientListTask extends AsyncTask<Void, Void, ArrayList<ClientScanResult>> { 
/ 线程 正在 后 台 处 理 
protected ArrayList<ClientScanResult> doInBackground(Void... params) { 


690 


| Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


/ 因为 检查 设备 的 连通 性 需要 访问 网 络 ， 所 以 获得 客户 端 队 列 的 操作 必须 在 分 线程 中 完成 
retum WifiUtil.getClientList(true); 
和 


/ 线程 已 经 完成 处 理 
protected void onPostExecute(ArrayList<ClientScanResult> clientList) { 
mListener.onGetClient(clientList); 


private GetClientListener mListener; / 声明 一 个 获得 客户 端的 监听 器 对 象 
/ 设置 获得 客户 端的 监听 器 
public void setGetClientListener(GetClientListener listener) { 

mListener = listener; 


1 


/ 定义 一 个 获得 客户 端的 监听 器 接口 
public interface GetClientListener { 
Void onGetClient(ArrayList<ClientScanResult> clientList); 


有 


(2) GetClientNameTask.java: 这 是 根据 IP 地 址 查找 设备 名 称 的 分 线程 。 因 为 查找 主机 


名 称 采用 了 NetBIOS 协议 ， 该 协议 需要 联网 操作 ， 所 以 设备 名 的 查询 动作 只 能 放 在 分 线程 中 
进行 。 按 照 上 一 小 节 的 叙述 ， 获 取 主 机 名 既 能 通过 Java 编码 ， 也 能 访问 JNI 接口 实现 ， 这 里 
的 示例 代码 采取 的 是 JNI 方式 ， 具 体 的 线程 处 理 代 码 如 下 : 


public class GetClientNameTask extends AsyncTask<String, Void, String> { 


// 线程 正在 后 台 处 理 

protected String doInBackground(String... params) { 
// 通过 JNI 方 式 获取 主机 名 。 由 于 NetBIOS 协议 需要 访问 网 络 ， 因 此 必须 在 分 线程 中 进行 。 
String info = WifiShareActivity.nameFromJNI(params[0]); 
return info; 


// 线程 已 经 完成 处 理 

protected void onPostExecute(String info) { 
mListener.onFindName(info); 

! 


private FindNameListener mListener; 。“”// 声明 一 个 发 现 设 备 名 称 的 监听 器 对 和 象 
// 设置 发 现 设备 名 称 的 监听 器 
public void setFindNameListener(FindNameListener listener) { 

mListener = listener; 


b 
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// 定义 一 个 发 现 设备 名 称 的 监听 器 接口 
public interface FindNameListener { 
void onFindName(String info); 
} 

(3) WifiShareActivity.java: 这 是 WiFi 共享 器 的 主页 面 。 除 了 要 处 理 基本 的 热点 开关 和 
修改 热点 配置 之 外 , 还 要 实时 扫描 有 哪些 设备 已 经 连 上 了 本 机 热点 。 下 面 的 代码 片段 就 演示 了 
如 何 获取 已 连接 设备 ， 以 及 如 何 获 得 这 些 设备 的 品牌 名 称 、 主 机 名 称 等 信息 。 

// 定义 一 个 已 连接 设备 的 扫描 任务 

private Runnable mClientTask = new Runnable() { 

public void run() { 

// 下 面 开启 分 线程 扫描 已 经 连 上 来 的 设备 
GetClientListTask getClientTask = new GetClientListTask(); 
getClientTask.setGetClientListener(WifiShareActivity.this); 
getClientTask.execute(); 
/ 延迟 3 秒 后 再 次 启动 已 连接 设备 的 扫描 任务 
mHandler.postDelayed(this, 3000); 





}; 


// 在 找到 已 连接 设备 后 触发 
public void onGetClient(ArrayList<ClientScanResult> clientList) { 
mClientArray = clientList; 
if (WifiUtil.getWifiApState(mWifiManager) != WifiUtil.WIFI AP_STATE_ENABLING 
&& WifiUtil.getWifiApState(mWifiManager) != WifiUtil.WIFI_AP_STATE ENABLED) 
{ V/ 未 开启 热点 

mClientArray.clear(); 

} else if (mClientArray 一 nulD) { 
mClientArray = new ArrayList<ClientScanResult>(); 

} 

让 (mClientArray.size() <= 0) { // 无 设备 连接 
tv_connect.setText(" 当 前 没有 设备 连接 "); 
ll_client title.setVisibility(View.GONE); 

}else { // 有 设备 连接 
String desc = String.format(" 当 前 已 有 %d 台 设 备 连 接 ", mClientArray.size()); 
ty_connect.setText(desc); 
ll_client title.setVisibility(View.VISIBLE); 

} 

// 为 每 个 设备 匹配 品牌 名 称 与 制造 厂商 

for (ClientScanResult item : mClientArray) { 
String ipAddr = item.getIpAddr(); 
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/ 根据 设备 的 MAC 地址 到 数据 库 中 查找 对 应 的 品牌 名 称 
item.setDevice(MacManager.getInstance(this).getMacDevice(item.getHWA ddr())); 
让 (mapName.containsKey(ipAddr)) { // 已 经 找到 该 他 对 应 的 主机 名 称 
item.setHostName(mapName.get(ipAddr)); 
} else { / 尚未 找到 该 他 对 应 的 主机 名 称 
/ 根据 设备 的 品牌 名 称 到 数据 库 中 查找 对 应 的 制造 厂商 
item.setHostName(MacManager.getInstance(this).getDeviceName(item.getDevice())); 
String upperDevice = item.getDevice().toUpperCase(); 
/ 若是 笔记 本 电脑 ， 则 依据 NetBIOS 协议 获取 该 设备 的 主机 名 
/ 这 里 只 处 理 几 款 主流 的 笔记 本 品牌 ， 包 括 联 想 、 惠 普 、 戴 尔 、 华 硕 、 宏 幕 、 东 芝 
if (upperDevice.equals("INTEL") || upperDevice.equals("HE WLETT") 
|| upperDevice.equals("DELL") || upperDevice.equals("ASUS") 
ll upperDevice.equals("ACER") || upperDevice.equals("TOSHIBA")) { 
// 下 面 开启 分 线程 根据 设备 的 人 P 地 址 获取 它 的 主机 名 称 
GetClientNameTask getNameTask = new GetClientNameTask(); 
getNameTask.setFindNameL istener(WifiShareActivity.this); 
getNameTask.execute(ipAddr); 


} 
b 
/ 把 已 连接 设备 通过 列表 视图 展现 出 来 
ClientListAdapter clientAdapter = new ClientListAdapter(this, mClientArray); 
lv_wifi_client.setAdapter(clientAdapter); 
上 


/ 声明 nameFromJNI 是 来 自 于 JNI 的 原生 方法 
public static native String nameFromJNI(String ip); 


/ 在 加 载 当 前 类 时 就 去 加 载 jni_mix.so， 加 载 动作 发 生 在 页 面 启动 之 前 
static { 

System.loadLibrary("jni_mix"); 
} 


// 在 找到 主机 名 称 时 触发 
public void onFindName(String info) { 
if (!TextUtils.isEmpty(info)) { 
String[] split = info.split(™"\|"); 
if (split.length > 1 && split[1].length() > 0) { 
// 添加 到 IP 地 址 与 主机 名 的 关系 映射 
mapName.put(split[0], split[1]); 
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14.5 ”实战 项 目 : 笔墨 味香 之 电子 书架 


书籍 是 知识 的 源泉 ， 更 是 进步 的 阶梯 ， 只 要 不 是 文盲， 每 个 人 都 热爱 看 书 。 看 教材 可 以 
求知 ， 看 小 说 可 以 娱乐 , 看 专业 书籍 可 以 提升 技能 ， 故 而 早 在 互联 网 诞生 之 初 ， 就 流传 着 海量 
电子 书籍 。 在 智能 手机 时 代 ， 通 过 手机 阅读 电子 书 更 是 方便 ， 像 爱 读 掌 阅 、 多 看 阅读 、 豆 辩 阅 
读 等 App 大 行 其 道 ， 为 移动 互联 网 增添 了 几 缕 墨 痕 书 香 。 本 章 末尾 的 实战 项 目 再 来 谈 谈 如 何 
设计 并 实现 手机 上 的 电子 书 阅 读 器 。 


14.5.1 ”设计 思路 








表面 上 看 电子 书 的 内 容 仅 仅 由 图 文 组 成 ， 解 析 起 来 似乎 要 比 音频 和 视频 简单 ， 但 实际 情 
况 并 非 如 此 。 音 视频 的 数据 流 虽 然 格 式 复杂 ， 却 遵循 少数 几 种 编码 标准 ， 因 此 Android 在 系统 
底层 早已 集成 了 相应 的 编 解 码 类 库 ， 业 务 层面 也 提供 了 MediaPlayer、VideoView 等 控件 ， 开 
发 者 只 需 调用 公开 的 方法 即 可 。 对 于 电子 书 来 说 ， 就 没 这 么 好 办 了 。 一 方面 电子 书 格式 多 样 ， 
有 TXT、CHM、UMD、PDF、EPUB、DJVU 等 类 型 ， 另 一 方面 Android 内 核 没 有 专门 的 控件 
用 于 显示 这 些 电 子 书 。 

当然 电子 书 的 两 个 问题 不 难 解决 ,前 一 个 问题 可 引入 第 三 方 的 电子 书 解码 库 ( 如 Vudroid)， 
后 一 个 问题 则 可 考虑 采取 以 下 的 折 中 办 法 : 


(1) 把 电子 书 的 每 一 页 都 泻 染 成 图 片 形 式 ， 然 后 便 能 利用 ImageView 观看 电子 书 了 。 
(2) 把 电子 书 的 每 一 页 解析 为 HTML 格式 ， 鉴 于 HTML 文件 内 部 支持 图 文 混 排 ， 于 是 
通过 WebView 即 可 浏览 网 页 形式 的 电子 书 。 
制定 了 切实 可 行 的 解决 方案 ， 接 下 来 才能 付 诸 编码 实现 。 为 减 小 实战 项 目的 复杂 度 ， 本 
项 目 和 暂且 支持 三 种 格式 的 电子 书 ， 分 别 是 PDF (“Portable Document Format”， 一 种 与 平台 无 
关 的 电子 文件 格式 ) 、EPUB (“Electronic Publication”， 文 件 内 容 使 用 XHTML 标准 构建 ) 、 
DJVU (主要 用 于 图 书 档案 和 古籍 的 数字 化 )。 接 着 来 看 看 如 图 14-44 和 图 14-45 所 示 的 电子 
书架 页 面 , 图 14-44 展示 了 阅读 器 的 初始 界面 , 其 中 自 带 了 三 种 格式 的 书籍 , 包括 PDF、EPUB、 
DJVU; 图 14-45 展示 了 修改 书籍 信息 并 添加 新 书 之 后 的 书架 ， 可 见 不 但 书 名 改 为 中 文 ， 而 且 
增加 了 页 数 统计 。 
照例 分 析 电 子 书 阅 读 器 可 能 用 到 了 哪些 融合 技术 ， 下 面 罗列 了 一 些 可 能 的 技术 点 ， 读 者 
不 妨 看 看 有 没有 遗漏 : 
(1) 网 页 视图 WebView: epub 开源 库 将 EPUB 文件 解析 成 许多 个 网 页 文件 ， 需 要 使 用 
WebView 浏览 。 
(2) 资产 管理 器 AssetManager: 初始 的 三 本 演示 电子 书 , 打包 进 App 工程 的 assets 目录 。 
(3) 异步 服务 IntentService: assets 目录 下 的 电子 书 无 法 直接 打开 ， 得 先 由 后 台 服务 复制 
到 SD 卡 再 打开 。 
(4) 数据 库 SQLite: 每 本 电子 书 的 书籍 名 称 、 作 者 、 页 数 ， 统 一 保存 到 数据 库 中 。 
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(5) JNI 开发 : 解析 PDF 和 DJVU 的 开源 库 Vudroid， 其 内 核 是 C 语言 编写 的 ， 所 以 要 
使 用 NDK 编译 为 so 文件 ， 然 后 在 Java 代码 中 通过 JNI 接口 调用 。 

(6) 图 片 文 件 处 理 : Vudroid 把 电子 书 提取 成 为 一 组 图 片 ， 因 此 要 进行 图 片 文件 的 保存 
和 打开 操作 。 
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图 14-44 ”电子 书 阅 读 器 的 初始 界面 图 14-45 添加 新 书籍 后 的 电子 书架 


另外 ,还 会 涉及 到 书籍 列表 用 到 的 ListView 或 者 RecyclerView, 翻 页 阅读 用 到 的 ViewPager 
和 Fragment 等 ， 如 此 种 种 不 一 而 足 。 


14.5.2 ”小 知识 : ”PDF 文件 泻 染 器 PdfRenderer 


Android 在 5.0 后 开始 支持 PDF 文件 的 读 取 ， 直 接 在 内 核 中 集成 了 PDF 的 演 染 操作 ， 很 
大 程度 上 方便 了 开发 者 ， 这 个 内 核 中 的 PDF 文件 泻 染 器 便 是 PdfRenderer。 泻 染 器 允许 直接 读 
取 存 储 卡 上 的 PDF 文件 ， 打 开 PDF 文件 的 代码 举例 如 下 : 


/ 打开 存储 卡 里 指定 路 径 的 PDF 文件 
ParcelFileDescriptor pfd = ParcelFileDescriptor.open( 
new File(mPath), ParcelFileDescriptor. MODE_READ ONLY); 
当然 ， 打 开 PDF 文件 只 是 第 一 步 ， 接 下 来 还 要 使 用 PdfRenderer 加 载 PDF 文件 ， 并 进行 
相关 的 处 理 操 作 ，PdfRenderer 类 的 常用 方法 说 明 如 下 。 


构造 函数 : 从 ParcelFileDescriptor 对 象 构造 一 个 PdfRenderer 实例 。 
getPageCount: 获取 PDF 文件 的 页 数 。 

openPage: 打开 PDF 文件 的 指定 页 面 ， 该 方法 返回 一 个 PdfRenderer.Page 对 象 。 
close: 关闭 PDF 文件 。 
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从 上 面 列 出 的 方法 看 到 ，PdfRenderer 只 是 提供 了 对 整个 PDF 文件 的 管理 操作 ， 具 体 的 页 





面 处 理 比如 泻 染 操作 得 由 PdfRenderer.Page 对 象 来 完成 ， 下 面 是 Page 类 的 常用 方法 说 明 。 














getIndex: 获取 该 页 的 页 码 。 
getWidth: 获取 该 页 的 宽度 。 
getHeight: 获取 该 页 的 高 度 。 
render: 渲染 该 页 面 的 内 容 ， 并 将 泻 染 结果 写 入 到 一 个 Bitmap 位 图 对 象 中 。 开 发 者 可 
在 此 把 Bitmap 对 象 保存 为 存储 卡 上 的 图 片 文件 。 
close: 关闭 该 页 面 。 


总 而 言 之 ，PdfRenderer 的 作用 就 是 把 一 个 PDF 文件 转换 为 若干 个 图 片 ， 开 发 者 再 将 这 些 


图 片 展示 到 屏幕 上 。 下 面 的 代码 片段 演示 了 如 何 解 析 并 显示 某 个 PDF 文件 的 所 有 页 面 : 


/ 开始 浑 染 PDF 文件 
Private void renderPDFO { 


/ 打开 存储 卡 里 指定 路 径 的 PDF 文件 
ParcelFileDescriptor pfd = ParcelFileDescriptor.open( 
new File(mPath), ParcelFileDescriptor. MODE_ READ ONLY); 
// 创建 一 个 PDF 泻 染 器 
PdfRenderer pdfRenderer = new PdfRenderer(pfd); 
/ 依次 处 理 PDF 文件 的 每 个 页 面 
for (inti= 0; i< pdfRenderer.getPageCount(); it+) { 
/ 生成 该 页 图 片 的 保存 路 径 
String imgPath = String.format("%s/%03d.jpg", mDir, 0); 
imgArray.add(imgPath); 
/ 打开 序号 为 i 的 页 面 
PdfRenderer.Page page = pdfRenderer.openPage(i); 
// 创建 该 页 面 的 临时 位 图 
Bitmap bitmap = Bitmap.createBitmap(page.getWidth(), page.getHeight(), 
Bitmap.Config.ARGB_ 8888); 
// 泻 染 该 PDF 页 面 并 写 入 到 临时 位 图 
page.render(bitmap, null, null, PdfRenderer.Page.RENDER_MODE_ FOR_DISPLAY); 
/ 把 位 图 对 象 保存 为 图 片 文件 
FileUtil.saveBitmap(imgPath, bitmap); 
page.close(); / 关闭 该 PDF 页 面 
/ 更 新 数据 库 记录 的 该 文件 页 数 
EbookReaderActivityupdatePageCount(mOriginPath, pdfRenderer.getPageCount(), null nulD); 
pdfRenderer.close(); / 处 理 完毕 ， 关 闭 PDF 演 染 器 


} catch (Exception el) { 


el.printStackTrace(); 


// 下 面 将 解析 出 来 的 PDF 页 面 组 图 通过 ViewPager 显示 出 来 
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PdfPageAdapter adapter = new PdfPageAdapter(getSupportFragment Manager(), imgArray); 
vp_content.setAdapter(adapter); 
} 
渲染 完成 的 PDF 页 面 显示 效果 如 图 14-46 和 图 14-47 所 示 , 其 中 图 14-46 为 解析 得 到 的 第 
-页 PDF 图 片 ， 图 14-47 为 解析 得 到 的 最 后 一 页 PDF 图 片 。 
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图 14-46 解析 得 到 的 第 一 页 PDF 图 片 14-47 解析 得 到 的 最 后 一 页 PDF 图 片 
14.5.3 ”代码 示例 
编码 与 测试 方面 ， 需 要 注意 以 下 几 点 : 
(1) 演示 用 的 电子 书 要 放 在 assets 目录 下 , 包括 tangshi.pdf、 lunyu.epub、zhugeliang.djvu。 
(2) 操作 存储 卡 ， 记 得 往 AndroidManifestxml 添加 SD 卡 的 权限 配置 : 


< SD 卡 一 

<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE" /> 
<uses-permission android:name="android.permission.MOUNT_UNMOUNT FILESYSTEMS" /> 


(3) AndroidManifest.xml 中 要 演示 电子 书 的 文字 复制 服务 ， 注 册 代 码 如 下 所 示 : 





<service android:name=".service.CopyFileService" android:enabled="true" /> 


(4) 在 模块 的 jni 目录 放置 Vudroid 库 包 括 mk 文件 在 内 的 所 有 源码 ， 并 修改 build.gradle 
文件 ， 在 android 节点 中 添加 以 下 几 行 配置 ， 表 示 支 持 把 C 代码 编译 为 so 文件 : 
externalNativeBuild { 
ndkBuild { 
path "src/main/jini/Android_vudroid.mk” // 这 是 编译 vudroid 专用 的 mk 文件 
! 
| 
(5) 编译 好 的 so 文件 记得 复制 一 份 到 jniLibs 目录 。 
(6) 在 工程 源码 中 导入 org.vudroid.pdfdroid 包 下 的 所 有 源码 , 该 包 内 部 集成 了 JNI 接口 ， 
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方便 开发 者 直接 调用 电子 书 的 解析 API。 

(7) 在 模块 的 libs 目录 放置 EPUB 解析 库 epublib-core-latestjar， 以 及 它 的 依赖 库 
slf4j-android-1.6.1-RC1.jar。 

(8) 准备 一 部 Android 4.X 的 手机 ， 还 有 一 部 Android 版 本 为 5.0 以 上 的 手机 ， 至 少 两 部 
手机 进行 测试 ， 从 而 分 别 测试 使 用 Vudroid 库 和 PdfRenderer 来 解析 PDF 文件 。 


写 代码 的 过 程 总 是 枯燥 的 , 不 如 先 看 看 最 终 的 效果 图 是 怎样 的 。 如 图 14-48 所 示 ， 这 是 在 
Android 4.4 手机 上 阅读 PDF 文件 《唐诗 三 百 首 》 的 截图 ， 此 时 采用 了 Vudroid 库 解 析 。 





登 蕉 省 楼 王 之 澳 
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14-48 采用 Vudroid 库 解析 PDF 书页 效果 


又 如 图 14-49 所 示 ， 这 是 在 手机 上 阅读 EPUB 文件 《论语 》 的 截图 。 再 如 图 14-50 所 示 ， 
这 是 在 手机 上 阅读 DJVU 文件 《诸葛 亮 传 》 的 截图 ， 此 时 采用 的 仍 是 Vudroid 库 。 
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【本 篇 引 语 】 | 
天 
《学 而 》 是 《论语 》 第 一 篇 的 篇 名 。 《论语 》 中 各 | 相 


1 
。《 学 而 》 一 篇 包括 16 章 ， 内 容 涉及 诸多 方面 。 
殿中 重点 是 “ 吾 日 三 省 吾 身 ”; “ 节 用 而 爱人 ， 使 
民 以 时 ”; “ 礼 之 用 ， 和 为 贵 ” 以 及 仁 、 孝 、 信 等 
障 德 范畴 。 


一 -一 一 一 





【原文 ] 


1 子 日 (1): “学 (2) 而 时 习 (3) 之 ,不 亦 说 (4) 乎 ? 
内 朋 (5) 自 远方 来 ， 不 亦 乐 (6) 乎 ? 人 不 知 (7), 而 不 
慢 (8)， 不 亦 君 子 (9) 乎 ? ” 


澡 闪 全 二 原 肝 于 沪 并 深 遇 L 主 注 兴 对 


[tds TaleLl to ats Nat nT 
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ee 
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【注释 ] 


1) 子 : 中 国 古 代 对 于 有 地 位 、 有 学 问 的 男子 的 苯 
， 有 时 也 泛称 男子 。《 论 语 》 书 中 “ 子 日 ”的 

















图 14-49 EPUB 文件 的 阅览 效果 图 14-50 DJVU 文件 的 阅览 效果 
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从 前 面 的 阅读 截图 可 见 ,， 逐 页 浏览 利用 了 ViewPager 控件 , 可 ViewPager 像 是 一 幅 从 左 到 
右 的 绵长 画卷 , 与 现实 生活 中 上 下 层 受 的 书籍 并 不 相似 。 若 想 让 手机 电子 书 更 贴近 纸 质 书 的 阅 
读 体验 ， 就 得 重新 设计 上 下 翻动 的 视图 ， 比 如 图 14-51 所 示 的 平滑 翻 页 效果 ， 上 下 两 页 存在 遮 
挡 的 情况 , 并 且 下 面 那 页 未 完全 显示 之 时 呈现 阴影 笼 单 。 当 然 翻 页 的 时 候 最 好 还 有 一 种 把 纸 卷 
过 来 的 效果 , 如 图 14-52 所 示 的 卷 纸 翻 页 , 看 起 来 更 逼真 、 更 赏心悦目 , 此 时 又 用 到 了 OpenGL 
技术 ,采取 三 维 图 形 演 染 器 将 图 片 扭曲 ， 从 而 达到 模拟 现实 的 阅读 感受 。 
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14-51 平滑 翻 页 的 阅读 效果 图 14-52 卷 纸 翻 页 的 阅读 效果 
下 面 简单 介绍 一 下 本 书 附录 源码 mixture 模块 中 ， 与 电子 书架 有 关 的 主要 代码 之 间 关 系 : 
(1) EbookReaderActivity.java: 这 是 阅读 器 的 书籍 列表 页 面 。 
(2) PdfRenderActivity.java: 这 是 PDF 电子 书 的 阅览 页 面 。 
(3) EpubActivity.java: 这 是 EPUB 电子 书 的 阅览 页 面 。 
(4) VudroidActivityjava: 这 是 使 用 Vudroid 浏览 电子 书 的 页 面 。 支 持 DJVU 格式 阅读 ， 
以 及 Android4.* 系 统 上 的 PDF 格式 阅读 。 
(5) CopyFileService.java: 把 assets 目录 下 的 三 本 电子 书 复制 到 手机 的 SD 卡 。 
最 后 列举 几 个 读 取 电 子 书 的 小 技巧 ， 首 先是 利用 Vudroid 库 读 取 PDF 和 DJVU 文件 的 代 
码 片段 示例 : 


/ 电子 书 可 能 有 很 多 页 ， 为 了 节约 系统 资源 ， 只 在 打开 某 页 时 采取 解析 该 页 的 图 像 数据 
/ 碎片 页 在 可 见 与 不 可 见 之 间 切 换 时 调用 
public void setUserVisibleHint(boolean isVisibleToUser) { 
super.setUserVisibleHint(isVisibleToUser); 
// 如 果 指 定 路 径 已 经 存在 图 片 文 件 ， 则 直接 显示 该 图 片 ， 否 则 需 从 头 解析 该 页 的 图 片 
if (mContext != null && isVisibleToUser && 
!(new File(mPath)).exists() &é& VudroidActivity.decodeService !=null) { 
readImage(); // 读 取 该 书页 的 图 像 


) 


/ 存储 卡 上 没有 该 页 的 图 片 ， 就 要 到 电子 书 中 解析 出 该 页 的 图 像 
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Private void readImage() { 
/ 弹出 进度 对 话 框 
mDialog = ProgressDialog.show(mContext, "请 稍 候 ", "正在 努力 加 载 "); 
String dir = mPath.substring(0, mPath.lastIndexOf("/")); 
final int index = Integer.parseInt(mPath.substring(mPath.lastIndexOf"/") + 1, 
mPath.lastIndexOf("."))); 
/ 解析 页 面 的 操作 是 异步 的 ， 解 析 结 果 在 监听 器 中 回调 通知 
VudroidActivity.decodeService.decodePage(dir, index, new DecodeService.DecodeCallback() { 
(@Overide 
public void decodeComplete(final Bitmap bitmap) { 
/ 把 位 图 对 象 保存 成 图 片 ， 下 次 直接 读 取 存 储 卡 上 的 图 片 文件 
FileUtil.saveBitmap(mPath, bitmap); 
// 解码 监听 器 在 分 线程 中 运行 ， 调 用 runOnUiThread 方法 表示 回 到 主线 程 操作 界面 
getActivity0.runOnUiThread(new Runnable() { 
@Override 
public void run() { 
// 把 位 图 对 象 显示 到 ImageView 控件 
iv_content.setImageBitmap(bitmap); 
if (mDialog != null && mDialog.isShowing() { 
mDialog.dismiss(); / 关闭 进度 对 话 框 
} 


》; 
上 
}, 1, new RectF(0, 0, 1, 1)): 
四 


然后 是 利用 EPUB 的 开源 库 解析 EPUB 文件 的 代码 片段 示例 : 
// 定义 一 个 书籍 泻 染 任务 


private class BookRender implements Runnable { 
public void run() { 
renderEPUBO; / 开始 泻 染 EPUB 文件 
if (mDialog != null && mDialog.isShowing()) { 
mDialog.dismiss(); / 关闭 进度 对 话 框 
} 


} 


// 开始 演 染 EPUB 文件 

Private void renderEPUB() { 
// 创建 一 个 EPUB 阅读 器 对 象 
EpubReader epubReader = new EpubReader(); 
Book book = null; 
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try{ 
// 从 指定 文件 路 径 创 建 输入 流 对 象 
InputStream inputStr = new FileInputStream(mPath); 
// 从 输入 流 中 读 取 书 籍 数 据 
book = epubReader.readEpub(inputStr); 
/ 设置 书籍 的 概要 描述 
setBookMeta(book); 
/ 获取 该 书 的 所 有 资源 ， 包 括 网 页 、 图 片 等 
Resources resources = book.getResources(); 
/ 获取 所 有 的 链接 地 址 
Collection<String> hrefArray = resources.getAllHrefs(); 
for (String href : hrefArray) { 
// 获取 该 链接 指向 的 资源 
Resource res = resources.getByHref(href); 
// 把 资源 的 字 节 数组 保存 为 文件 
FileUtil.writeFile(mDir + "/" + href, res.getData()); 
} 
} catch (Exception e) { 
e.printStack Trace(); 
b 
ArrayList<String> htmlArray = new ArrayList<String>(); 
/ 获取 该 书 的 所 有 内 容 页 ， 也 就 是 所 有 网 页 
List<Resource> contents = book.getContents(); 
for (inti= 0; i< contents.size(); i++) { 
/ 获取 该 网 页 的 链接 地 址 ， 并 添加 到 网 页 队列 中 
String href = String.format("%s/%s", mDir, contents.get(i).getHref()); 
htmlArray.add(href); 
上 
/ 下 面 使 用 ViewPager 展示 每 页 的 WebView 内 容 
EpubPagerAdapter adapter = new EpubPagerAdapter(getSupportFragmentManager(), htmlArray); 
vp_content.setAdapter(adapter); 
} 


/ 设置 书籍 的 概要 描述 
private void setBook Meta(Book book) { 

/ 书籍 的 头 部 信息 ， 可 获取 标题 、 语 言 、 作 者 、 封 面 等 信息 

Metadata meta = book.getMetadata(); 

/ 获取 该 书 的 作者 列表 

List<Author> authorArray = meta.getAuthors(); 

String autors = "作者 : "; 

for (inti= 0;i< authorArraysizeO: i++) { 

it 一 0){ 
autors = String.format("%s’%s", autors, authorArray.get(i).toString()); 
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jelse 上 
autors = String.format("%s, %s", autors, authorArray.get(i).toStringO); 
} 
} 
autors = autors.replace(",", ""); 
/ 获取 该 书 的 主 标题 
String title = meta.getFirstTitle(); 
if (TextUtils.isEmpty(title)) { 
if (!TextUtils.isEmpty(mTitle)) { 
title = mTitle; 
}else{ 
title = FileUtil.getFileName(mPath); 
} 
} 
/ 获取 该 书 的 页 数 ， 同 时 更 新 数据 库 中 该 书信 息 
EbookReaderActivity.updatePageCount(mPath, 
book.getContents().size(), title, autors); 
String fullTitle = String.format("%s (%s) ", title, autors); 
tv_title.setText(fullTitle); 


14.6 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 常见 融合 技术 ,包括 网 页 集成 (资产 管理 器 、 网 页 视图 、 
简单 浏览 器 ) 、JNI 开 发 (NDK 环境 搭建 、 创建 JNI 接口 、JNI 实现 加 解密 ) 、 局 域 网 开发 (无 
线 网 络 管理 器 、 连 接 WiFi、 开 关 热 点 、 点 对 点 蓝牙 传输 ) 。 最 后 设计 了 两 个 实战 项 目 ， 一 个 
是 “WiFi 共享 器 ”， 另 一 个 是 “电子 书 阅读 器 ”。 在 “WiFi 共享 器 ”的 项 目 编码 中 ， 采 用 了 


NetBIOS 协议 的 实际 运用 。 在 “电子 书 阅 读 器 ”的 项 目 编码 中 ， 结 合 运用 多 项 融合 技术 ， 以 及 
各 种 图 形 图 像 处 理 手段 ， 完 成 了 具备 实用 价值 的 功能 开发 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 5 种 开发 技能 : 

(1) 学 会 使 用 网 页 视图 集成 网 页 显示 。 

(2) 学 会 实现 JNI 接口 的 编码 与 调用 。 

(3) 学 会 使 用 蓝牙 技术 完成 设备 之 间 的 数据 传输 。 

(4) 学 会 使 用 无 线 网 络 管理 器 进行 WiFi 热点 的 管理 操作 。 

(5) 学 会 综合 上 述 技术 实现 电子 书 阅读 器 的 基本 功能 。 


手机 App 的 功能 日 益 丰 富 ， 除 了 Android 系统 自身 不 断 更 新 换代 ， 更 离 不 开 众多 服务 提供 商 
的 开发 包 。 本 章 介绍 App 开发 常见 的 第 三 方 开发 包 ， 主 要 包括 国内 两 家 主要 的 地 图 服务 开发 〈 百 
度 地 图 和 高 德 地 图 ) 、 全 球 华人 主要 的 两 个 分 享 渠道 开发 〈QQ 分 享 和 微 信 分 享 ) 、 国 内 两 家 主 
要 的 支付 服务 开发 〈 支 付 宝 和 微 信 支 付 ) 、 中 文 世 界 主要 的 语音 服务 开发 〈 讯 飞 语音 的 语音 识别 
和 语音 合成 ) 。 最 后 结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 仿 滴 滴 打 车 ”的 设计 与 实现 。 


15.1 地 图 SDK 


地 图 是 人 们 日 常生 活 中 不 可 或 缺 的 工具 ， 手 机 上 与 地 图 有 关 的 功能 也 很 常见 ， 比 如 定位 
自己 在 哪 条 街道 什么 位 置 、 查 查 周 边 有 哪些 好 吃 好 玩 的 地 方 等 。 由 于 地 图 功能 与 用 户 所 在 国家 
密切 相关 ， 因此 Android 系统 自身 并 不 提供 地 图 功能 ，App 需要 接 入 第 三 方 地 图 开发 包 才能 实 
现 相 关 功 能 。 国 内 常用 的 地 图 SDK 包括 百度 地 图 和 高 德 地 图 ， 本 节 对 这 两 个 地 图 的 开发 包 分 
别 进行 介绍 。 


15.1.1 查看 签名 信息 

















尽管 现在 App 的 反 破 解 手段 已 经 很 多 了 ， 但 是 道 高 一 尺 、 魔 高 一 丈 ， 各 种 山寨 版 的 App 
仍然 层出不穷 。App 的 包 名 相当 于 人 们 的 身份 证 ， 然 而 这 个 身份 证 很 容易 被 伪造 ， 如 果 持 有 同 
样 的 身份 证 号 , 我 们 每 知 对方 是 真是 假 ? 这 时 就 要 引入 其 他 身份 鉴 伪 标 志 。 对 于 人 类 来 说 , 可 
以 通过 指纹 识别 是 否 为 本 人 。 对 于 App 来 说 , 也 有 类 似 指 纹 的 标志 信息 ， 即 App 的 签名 信息 。 
如 果 黑 客 自 改 了 App 的 安装 包 ， 那 么 签名 信息 必然 发 生变 化 ， 通 过 校 验 签名 就 能 鉴别 该 App 
的 真 伪 。App 有 了 签名 作为 身份 信息 ， 才 允许 在 Android 系统 上 安装 和 运行 。 

应 用 一 般 把 SHA1 作为 签名 信息 。 在 开发 阶段 ，Android Studio 使 用 自 带 的 签名 文件 
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debug.keystore 给 App 签名 ; 在 上 线 阶 段 ， 开 发 者 提供 自己 的 签名 文件 给 App 做 正式 签名 。 有 
的 第 三 方 SDK《〈 如 地 图 类 的 开发 包 ) 需要 开发 者 分 别提 供 开发 版 的 签名 和 发 布 版 的 签名 ， 以 
此 判断 App 能 否 正 常 使 用 地 图 功能 。 这样 一 来 , 大 家 就 比较 关心 如 何 才能 知晓 自己 的 Android 
Studio 用 的 是 什么 签名 ? 下 面 分 别 介绍 一 下 开发 版 签名 和 发 布 版 签名 的 获取 方法 。 


1. 开发 版 签名 


Android Studio 自 带 的 签名 文件 位 于 用 户 目录 
的 .android/debug.keystore。 打 开 Android Studio， 主 界 
面 右边 有 一 个 竖 排 的 Gradle 按钮 , 单 击 该 按钮 弹出 当 
前 项 目的 概念 结构 窗口 ， 点 开 项 目 名 称 内 部 的 
Tasks/android 目录 ,发现 其 下 有 3 个 工具 ， 分 别 是 





Gradle projects 将 " 省 
人 + 一 | 全 | 王 皇 申 | 小 | 车 
Y ©@Helloyorld 
©Helloyorld (r 
Y [oTasks 
Y [oandroid 
FandroidDependencies 





三 sourceSets 


androidDependencies、signingReport 和 sourceSets， 具 
体 的 目录 结构 如 图 15-1 所 示 。 i 
» 加 other 


这 里 的 signingReport 为 签名 报告 工具 ， 双 击 
signingReport 运行 该 工具 ， 之 后 Android Studio 开始 
查找 并 报告 每 个 模块 的 开发 签名 。 报 告 结果 打印 在 主 
界面 左下 方 的 signingReport 窗口 , 框 起 来 的 SHA1 字 
符 串 为 模块 thirdsdk 的 开发 签名 ， 如 图 15-2 所 示 。 


Run 休 HelloWorld [signingReport] 


» [overification 
» © :anination 
* :app 
> © :custon 


图 15-1 Gradle 项 目的 结构 图 











P IB variant: debugUnitTest 
Config: debug 
Store: C:\Users\ouyangshen\. android\debug. keystore 
Alias: AndroidDebugKey 
MD5: 82:D6:C0:FB:C0:C2:A2:CD:1C:1D:AC 1A:68:D6 


Valid until: 2047 年 11 月 20 日 星期 三 





图 15-2 开发 版 签名 的 查询 结果 


默认 的 调试 签名 文件 通常 不 会 更 改 ， 当 然 也 有 例外 情况 ， 比 如 微 信 平台 SDK 的 演示 工程 
要 求 使 用 demo 工程 自 带 的 签名 文件 。 若 要 更 换 调 试用 的 签名 文件 ， 则 需要 修改 对 应 模块 的 
build.gradle， 即 在 该 编译 文件 的 android 节点 下 补充 签名 配置 ， 表 示 开 发 版 签名 使 用 当前 模块 
目录 下 的 debug.keystore。 
signingConfigs { 
debug { 
storeFile file("debug.keystore") 
上 
上 


2. 发 布 版 签名 
第 8 章 介 绍 App 发 布 时 提 到 使 用 密 钥 文 件 为 App 打包 安装 包 ， 这 个 密 钥 文 件 就 是 发 布 版 
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的 签名 文件 。 依 次 选择 菜单 Build 一 Generate Signed APK...， 在 弹出 的 窗口 中 选择 待 打 包 的 模 
块 ， 进 入 APK 签名 窗口 页 面 ， 如 图 15-3 所 示 。 

这 里 的 testjks 为 发 布 用 的 签名 文件 ， 若 想 查看 该 文件 的 签名 信息 ， 则 可 打开 命令 提示 符 
窗口 ， 在 命令 行 输入 keytool -v -list -keystore F:\StudioProjects\test.jks， 然 后 回 车 运行 该 命令 ; 
接着 窗口 提示 输入 密 钥 库 口 令 ， 该 口令 为 密 钥 文件 的 密码 ,输入 密码 并 回 车 ， 稍 等 一 会 儿 ， 命 
令 行 窗口 会 把 该 密 钥 文件 的 详细 签名 信息 打印 出 来 ， 完 整 的 签名 信息 如 图 15-4 所 示 。 注 意 ， 
框 起 来 的 SHA1 字符 串 为 发 布 版 的 签名 串 。 





























Generate Signed APK Css 





Key store path: F:\Studioprojects\test. jks 
Create ney... Choose eristing... 


Key store password: | 





Key allas 
Key password: eos 


Renenber passwcrds 


Es) WE or Cs 








图 15-3 APK 签名 窗口 图 15-4 发布 版 签名 的 查询 结果 
15.1.2 ”百度 地 图 


百度 地 图 的 开发 网 址 是 http://lbsyun.baidu.com/， 进 入 该 网 站 后 ， 依 次 选择 “开发 文档 ” 
一 “Android 开发 ”一 “Android 地 图 SDK” 一 “产品 下 载 ”， 即 可 打开 百度 地 图 的 SDK 下 载 
页 面 。 开 发 者 可 在 此 页 面 选择 “ 自 定义 下 载 ” 或 “一 键 下载 ”。 当 然 , 作为 勤奋 好 学 的 开发 者 ， 
有 必要 了 解 地 图 SDK 的 具体 组 件 ， 这 里 建议 选择 “ 自 定义 下 载 ”， 打 开 的 地 图 组 件 页 面 如 图 
15-5 所 示 。 








© © 


A ® 








HE HS 
图 15-5 百度 地 图 SDK 的 下 载 页 面 
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在 该 页 面色 选 需要 集成 的 组 件 ， 单 击 页 面 左 下 方 的 “开发 包 ” 按 钮 ， 下 载 包 含 对 应 组 件 
的 地 图 SDK; 单 击 “ 示 例 人 代码” 按钮， 可 下 载 官方 的 demo 工程 源 代码 。 
有 了 地 图 SDK， 还 得 申请 开发 者 账号 和 测试 应 用 账号 ， 才 能 在 测试 应 用 中 正常 使 用 地 图 


功能 。 具 体 的 申请 步骤 如 下 : 
G301 打开 百度 地 图 开放 平台 网 址 http://lbsyun.baidu.com/， 先 单 击 “ 控 制 台 ”进入 应 用 管 





理 页 面 











， 再 单 击 左 侧 的 “创建 应 用 ”， 打 开 应 用 创建 页 面 ， 如 图 15-6 所 示 。 





申请 记录 中 心 





| @ lbsyun. baidu com apiconssle /key/create 





:服务 北 
云 存 储 
正 池 地 理 编码 
震 志 一 


启用 服务 : 


庚 限 外 迹 
批量 算 路 
推荐 上 车 点 


云 栓 索 
普通 IP 赴 位 
全 景 矢志 图 
到 达 画 
云 地 理 乱码 


图 15-6 百度 地 图 的 应 用 创建 页 面 


地 点 检索 

路 线 规划 

从 标 转换 

去 地 地 理 编码 
时 区 

















人 62 在 应 用 创建 页 面 填写 应 用 名 称 ， 应 用 类 型 下 拉 选 择 “Android SDK”， 接 着 勾 选 需要 








启用 的 服务 , 并 在 下 方 输入 测试 应 用 的 包 名 和 SHA1 签名 串 , 视 情况 可 同时 填 入 发 布 版 签名 和 开发 








版 签名 。 然后 下 方 的 安全 码 会 自动 生成 一 个 字符 串 , 其 实 就 是 SHA1+ 包 名 , 填写 页 面 例 


所 示 。 





[DFR sem baitu con arsescie Mer creoe 
全 ) 创建 应 用 








了 : 惠 运 地 本 


:Android SDK 


图 三 位 过 
图 Andrcid 二 asSDK 





195:CFF8:D7:43.3C7430.95.86.f6:9636:10E8.DFOCA5.6 © 





hirdsdk 


Android SDK 空 胡 成 : SHA1+ 包 去. (三 
与 Browser 闫 型 的 ak 不 再 支 竺 云 存储 过 口 的 沪 问 


Serverssak. 


提交 


回 2 于 入 码 

图 Android 导 策 毫 线 SDK 
主导 起 志 辟 

国 全 URL API 

回 三 地 至 冯 


~ ED95:CFF8D7:433C743095:86f6:963610EBDFOCA563;comexamplet 





导 方 法 ) 新 申请 的 Mobile 
如 要 使 用 去 乞 侍 ,请 中 请 


图 Android 地 图 SDK 

图 AndroidSstsDK 

汪 标 办 地 

Android 导 艇 HUD SDK 


图 准 符 上 二 点 








图 15-7 Android 测试 应 用 的 信息 填写 页 面 


子 如 图 15-7 


706 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 





2703 填写 完毕 后 单 击 “提交 ”按钮 ， 回 到 应 用 列表 页 面 ， 可 见 列表 新 增 了 一 条 刚 创 建 的 
























































应 用 记录 ， 如 图 15-8 所 示 。 此 时 这 个 测试 应 用 账号 就 申请 完成 了 ， 记 下 应 用 信息 第 三 列 的 AK 值 
( 即 API KEY)， 后 面 会 用 到 。 

习 应 用 列表 认证 状 

应 用 编号 。 应 用 名 称 访问 应 用 (AK) 应 用 类 到 (关于 殉 站】 应 用 了 和 

11189871 ” 测 寺 tb 图 3LL9QyWiD134jz2ejzAyH2bdm6wggneO 。 Android 请 








图 15-8 创建 完成 后 的 应 用 列表 页 面 


完成 测试 应 用 的 账号 申请 后 ， 接 下 来 进行 地 图 开发 环境 的 搭建 工作 。 
首先 ， 打 开 AndroidManifestxml， 在 application 节点 下 补充 百度 地 图 的 密 钥 配 置 。 其 中 ， 
android:value 字段 值 为 应 用 基本 信息 的 AK 值 ， 即 API Key。 具 体 配置 代码 如 下 : 
<!-- 百度 地 图 密 钥 --> 
<meta-data 
android:name="com.baidu.lbsapi.API KEY" 
android:value="vRbVCiHqbhdkcoG8wOQwQvdX" 亡 
同时 还 要 注册 百度 地 图 的 定位 服务 ， 有 具体 的 服务 注册 代码 如 下 : 
<service 
android:name="com.baidu.location.f" 
android:enabled="true" 
android:process=":remote" /> 
其 次 , 把 SDK 包 里 的 BaiduLBS_Android.jar 复制 到 模块 的 libs 目录 。 除 jar 文件 外 ， 把 其 
余 so 库 的 所 有 文件 夹 复 制 到 src/main/jniLibs 目录 下 。 
最 后 ， 把 官方 demo 工程 里 的 com/baidu/mapapi/overlayutil 整个 目录 源码 复制 到 你 的 工程 
中 。 该 目录 的 源码 用 于 POI 搜索 ， 原 本 包含 在 SDK 的 jar 包 中 ,不 过 百度 地 图 SDK3.6 及 以 后 
版 本 不 再 内 置 这 部 分 代码 ， 所 以 需要 开发 者 自行 将 这 块 源码 加 入 工程 中 。 
好 不 容易 搞定 了 地 图 功能 的 账号 申请 与 环境 搭建 ， 终 于 进入 大 家 最 期 待 的 地 图 开发 环节 
了 。 地 图 的 开发 有 很 多 应 用 场景 ， 这 里 选取 几 个 常用 又 相对 简单 的 功能 ， 方 便 读 者 快速 上 手 。 
这 些 功 能 包括 显示 地 图 并 定位 、POI 搜索 、 距 离 与 面积 测量 ， 分 别 介绍 如 下 。 


1. 显示 地 图 并 定位 
对 于 地 图 SDK 来 说 ， 最 基础 的 功能 是 显示 当前 城市 的 地 图 。 编 码 需要 注意 以 下 几 点 : 


(1) 在 加 载 页 面 布局 前 要 先 对 SDK 进行 初始 化 操作 , 即 在 setContentView 方法 之 前 插入 
下 面 这 行 代码 : 


第 15 章 第 三 方 开发 包 | 707 





/ 初始 化 百度 地 图 SDK 
SDKInitializer.initialize(getApplicationContext()); 


-开始 要 先 隐藏 地 图 图 层 ， 等 定位 到 当前 城市 后 再 开启 图 层 显示 。 如 果 一 开始 默认 





显示 北京 地 图 ， 就 不 会 直接 显示 当前 城市 的 地 图 了 。 


地 图 相关 类 及 对 应 的 方法 较 多 ， 且 在 不 断 更 新 中 ， 无 法 一 一 列举 ， 读 者 可 参考 百度 地 图 
官网 的 最 新 API 说 明文 档 。 下 面 是 有 关 地 图 显示 与 定位 的 代码 : 


private MapView mMapView; / 声明 一 个 地 图 视图 对 象 

private BaiduMap mMapLayer; // 声明 一 个 地 图 图 层 对 象 
private LocationClient mLocClient / 声明 一 个 定位 客户 端 对 象 
private boolean isFirstLoc = true; // 是 否 首 次 定位 


// 初始 化 地 图 定位 


private void initLocationO { 


1 


// 从 布局 文件 中 获取 名 叫 bmapView 的 地 图 视图 

mMapView = findViewById(R.id.bmapView); 

/ 先 隐藏 地 图 ， 待 定位 到 当前 城市 时 再 显示 
mMapView.setVisibility(View.INVISIBLE):; 

mMapLayer =mMapView.getMap(); / 从 地 图 视图 中 获取 地 图 图 层 
mMapLayer.setOnMapClickListener(this); / 给 地 图 图 层 设置 地 图 点 击 监听 器 
mMapLayersetMyLocationEnabled(true); / 开启 定位 图 层 

mLocClient = new LocationClient(this); / 创建 一 个 定位 客户 端 
mLocClient.registerLocationListener(new MyLocationListenner()); “// 设置 定位 监听 器 
LocationClientOption option = new LocationClientOption(0); / 创建 定位 参数 对 象 
option.setOpenGps(true); / 打开 GPS 

option.setCoorType("bd091I); / 设置 坐标 类 型 

option.setScanSpan(1000); / 设置 定位 的 时 间 间 隔 
option.setIsNeedAddress(true); / 设置 true 才能 获得 详细 的 地 址 信息 
mLocClient setLocOption(option); / 给 定位 客户 端 设置 定位 参数 
mLocClient.start(); / 命令 定位 客户 端 开始 定位 


// 定义 一 个 定位 监听 器 
public class MyLocationListenner implements BDLocationListener { 


/ 在 接收 到 定位 消息 时 触发 
public void onReceiveLocation(BDLocation location) { 
// 如 果 地 图 视图 已 经 销毁 ， 则 不 再 处 理 新 接收 的 位 置 
if (location — null || mMapView 一 nulD) { 
Teturn; 
} 
mLatitude = location.getLatitude(); / 获得 该 位 置 的 纬度 
mLongitude = location.getLongitude(); // 获得 该 位 置 的 经 度 
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String position = String.format(" 当 前 位 置 : %s|%s|%s|%s|%6s|%s|%s"， 
location.getProvince(), location.getCity(), 
location.getDistrict(), location.getStreet(), 
location.getStreetNumber(), location.getAddrStr(), 
location.getTime()); 
ty_loc_position.setText(position); 
MyLocationData locData = new MyLocationData.Builder() 
.accuracy(location.getRadius()) 
// 此 处 设置 开发 者 获取 到 的 方向 信息 ， 顺 时 针 0-360 
.direction(100).latitude(mLatitude).longitude(mLongitude) 
.build(); 
mMapLayer.setMyLocationData(locData); / 给 地 图 图 层 设置 定位 地 点 
if(isFirstLoc){ // 首次 定位 
isFirstLoc = false; 
LatLng 1l1=new LatLng(mLatitude, mLongitude); / 创建 一 个 经 纬度 对 象 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLngZoom(ll, 14); 
mMapLayeranimateMapStatus(update); / 设置 地 图 图 层 的 地 理 位 置 与 缩放 比例 
mMapView.setVisibility(View.VISIBLE); / 定位 到 当前 城市 时 再 显示 图 层 


} 


百度 地 图 定位 与 显示 的 效果 如 图 15-9 所 示 。 展 示 的 
界面 是 笔者 所 在 城市 的 地 图 ， 中 央 的 圆 点 为 笔者 当前 所 
城市 中 搜索 ~ ”开始 下 一 组 数据 


处 的 位 置 。 性 福州 | 市 内 找 公园 | 
当前 位 置 ， 福建 当 | 而 玫 市 | 占 简 区 中国 柱 开 | 


2. POI 搜索 e106-24 15.08351 


POI 即 地 图 注 点 ， 是 Point Of Interest 的 缩写 ， 通 过 
在 地 图 上 标注 地 点 名 称 、 类 别 、 经 度 、 纬 度 等 信息 实现 
携带 位 置信 息 的 地 图 标注 功能 。POI 搜索 是 地 图 SDK 的 
-个 重要 功能 ， 根 据 关键 词 搜索 并 在 地 图 上 显示 周边 地 
点 的 查询 结果 ， 是 智能 出 行 的 基础 。 

POI 搜索 的 详细 代码 行 较 多 ， 为 节约 篇 幅 ， 这 里 就 
不 贴 出 来 了 ， 读 者 可 参考 本 书 的 下 载 资 源 。 百 度 地 图 搜 
索 POI 的 效果 如 图 15-10 和 图 15-11 所 示 。 其 中 ,图 15-10 
为 输入 关键 词 “公园 ”后 的 查询 结果 ; 点 击 其 中 某 个 标 
注 ， 页 面 下 方 弹出 小 窗口 提示 该 标注 代表 的 公园 信息 ， 
如 图 15-11 所 示 。 














15-9 百度 地 图 定位 到 当前 城市 
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thirdsdk thirdsdk 


当 部 位置， 生生 二 放生 你 中国 可 


清除 标记 埋 宫 放 市 六 模 区 |2018-05-24 15:06:51 当 而 位 置 ， 本 攻 乔 且 


ME 
清除 标记 若 福 州 市 昌 硬 区 |2018-05-24 1505:06 


ers 


2 


pe 





图 15-10 百度 地 图 的 POI 搜索 结果 15-11 点击 某 个 POI 弹出 标注 信息 
3. 距离 与 面积 测量 


测量 距离 和 测量 面积 是 地 图 SDK 的 一 个 常见 功能 ， 该 功能 除了 在 地 图 上 添加 标注 外 ， 还 
要 用 到 数学 中 的 两 个 公式 。 

其 中 ， 测 距 用 的 是 色 股 定理 〈 商 高 定理 ) 。 色 股 定理 是 一 个 基本 的 几何 定理 : 一 个 直角 
三 角形 ， 两 直角 边 的 平方 和 等 于 斜 边 的 平方 。 如 果 直 角 三 角形 两 直角 边 为 a 和 b、 和 斜 边 为 c， 
那么 a2+b? =c?。 

测 面积 用 的 是 海伦 公式 〈 秦 九 韶 公 式 ) 。 海 伦 公式 是 利用 三 角形 的 3 个 边 长 直接 求 三 角形 面 
积 ， 表 达 式 为 ，S = Vp@p 一 引 (p 一 b)@ 一 。 基 于 海伦 公式 ， 可 以 推导 出 根据 多 边 形 各 边 长 求 多 边 
形 面积 的 公式 ， 即 S = ( (xoyi-xiyo) + (Xiy2-X2y1) 十 … + (Xnyo-Xoyn) )/2 。 

进行 测量 时 ， 还 要 在 地 图 上 添加 标记 ， 如 一 条 线段 的 两 个 顶点、 一 个 多 边 形 的 各 个 顶点， 
由 此 衍生 各 种 形状 的 添加 方式 。 调 用 MapLayer 对 象 的 addOverlay 方法 即 可 在 地 图 上 添加 标记 ， 
可 添加 的 标记 形状 说 明 见 表 15-1。 


表 15-1 百度 地 图 的 标记 说 明 




















百度 地 图 的 标记 类 MapLayer 类 的 添加 方法 
ArcOptions addOverlay 
CircleOptions addOverlay 
MarkerOptions addOverlay 
PolygonOptions addOverlay 
PolylineOptions addOverlay 
TextOptions addOverlay 











弄 懂 了 测量 的 算法 原理 和 在 地 图 上 添加 标记 的 方法 ， 测 距 与 测 面积 的 实现 就 不 难 了 。 为 
节省 篇 幅 ， 这 里 不 再 贴 出 距离 与 面积 测量 的 代码 ， 读 者 可 自行 查看 本 书 下 载 资源 中 的 代码 。 
使 用 百度 地 图 测 距 与 测 面积 的 效果 如 图 15-12 和 图 15-13 所 示 。 其 中 ， 图 15-12 展示 了 森 


710 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


林 公 园 与 西湖 的 测 距 结果 , 可 以 看 到 两 点 之 间距 离 5.9 千 米 。 再 来 看 面积 测量 的 结果 , 图 15-13 
显示 西湖 公园 的 面积 大 约 是 84 万 平方 米 。 








城市 中 搜索 ” 开始 下 一 组 数据 
加 市 内 找 
Wat | 
i 
7 
IS 区 基建 百 公安 厅 
划 
CN 3 = 
aes 
i 
SJ - 
-si 
SimW HR DS x 十 可 
x NR 二 
15-12 ”百度 地 图 的 距离 测量 结果 图 15-13 ”百度 地 图 的 面积 测量 结果 


15.1.3 ”高 德 地 图 


高 德 地 图 的 开发 网 址 是 http://lbs.amap.com/， 进 入 该 网 站 后 ， 依 次 选择 “开发 支持 ”一 
“Android 平台 ”一 “Android 地 图 SDK”， 将 页 面 拉 到 底 ， 单 击 左下 方 的 “相关 下 载 ”链接 ， 
打开 下 载 页 面 ， 如 图 15-14 所 示 。 





图 15-14 高 德 地 图 SDK 的 下 载 页 面 


单 击 下 载 页 面 的 “ 自 定义 下 载 ” 按 钮 ， 向 下 拉 出 
组 件 列表 , 勾 选 需要 下 载 的 组 件 与 资料 , 然后 单 击 “ 下 
载 ” 按 钮 开始 下 载 地 图 SDK 与 示例 代码 。 a | 
高 德 地 图 也 需要 申请 开发 者 账号 和 测试 应 用 账 | .在 
号 ,使 用 开发 者 账号 登录 后 ， 即 可 在 网 页 右上 角 找到 
“控制 台 ” 链 接 ， 依 次 单 击 “ 控 制 台 ”一 “创建 新 应 
用 ”， 弹 出 “创建 应 用 ”窗口 ， 如 图 15-15 所 示 。 15-15 ”高 德 地 图 的 “创建 应 用 ”窗口 
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填写 应 用 名 称 并 选择 应 用 类 型 ， 然 后 单 击 “ 创 建 ” 按 钮 ， 即 可 看 到 应 用 列表 增加 了 一 条 
刚 创建 的 应 用 记录 ， 如 图 15-16 所 示 。 





| 我 的 枚 用 加 











图 15-16 ”测试 应 用 的 初始 信息 


单 击 应 用 记录 右边 的 “添加 新 Key” 按 钮 ， 弹 出 “为 第 三 方 应 用 添加 Key” 窗 口 ， 在 此 可 
设置 应 用 的 Key 名 称 、SHA1 签名 、 包 名 等 信息 ， 如 图 15-17 所 示 。 





图 15-17 “为 第 三 方 应 用 添加 Key” 窗 口 


在 设置 窗口 填写 测试 应 用 的 Key 名 称 ， 选 中 服务 平台 Android 平台 SDK， 并 分 别 填写 发 
布 版 签名 、 调 试 版 签名 (开发 签名 ) 、Package〈 包 名 ) ， 注 意义 选 “ 我 已 阅读 ***”， 然 后 单 
击 “ 提 交 ” 按 钮 完成 设置 操作 。 回 到 应 用 列表 页 面 ， 此 时 测试 应 用 下 面 多 了 一 条 刚 添加 的 Key 
记录 ， 如 图 15-18 所 示 。 记 下 这 里 的 Key 值 ， 后 面 会 用 到 。 





图 15-18 ”测试 应 用 的 键 值 信息 


测试 应 用 账号 申请 完成 ， 继 续 搭 建 高 德 地 图 的 开发 环境 。 
首先 ， 打 开 AndroidManifest.xml， 在 application 节点 下 补充 高 德 地 图 的 密 钥 配 置 。 其 中 ， 
android:value 字段 值 为 测试 应 用 的 Key 值 。 具 体 配 置 代码 如 下 : 


<!- 高 德 地 图 密 钥 --> 
<meta-data 
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android:name="com.amap.api.v2.apikey" 
android:value="d2d98282615cb90e78b4be537636647c" /> 


同时 还 要 注册 高 德 地 图 的 定位 服务 ， 具 体 的 服务 注册 代码 如 下 : 
<service android:name="com.amap.api.location.APSService" /> 


其 次 ， 把 SDK 包 里 的 AMap***.jar 复制 到 模块 的 libs 目录 ，JAR 文件 可 能 只 有 一 个 ， 也 
可 能 有 多 个 ， 如 AMap2DMap***.jar、AMapSearch***.jar、AMapLocation***.jar 等 ， 如 此 便 完 
成 了 高 德 地 图 的 开发 环境 搭建 工作 。 

下 面 介绍 高 德 地 图 的 3 个 主要 功能 : 显示 地 图 并 定位 、POI 搜索 、 距 离 与 面积 测量 。 


1. 显示 地 图 并 定位 


高 德 地 图 也 要 先 隐藏 地 图 图 层 ， 等 到 定位 到 当前 城市 后 再 开启 图 层 显 示 。 具 体 的 定位 代 
码 如 下 : 


private MapView mMapView; / 声明 一 个 地 图 视图 对 象 

private AMap mMapLayer; / 声明 一 个 地 图 图 层 对 象 

private AMapLocationClient mLocClient; / 声明 一 个 定位 客户 端 对 象 

Private boolean isFirstLoc = true; // 是 否 首次 定位 

/ 初始 化 地 图 定位 

private void initLocation(Bundle savedInstanceState) { 
/ 从 布局 文件 中 获取 名 叫 amapView 的 地 图 视图 
mMapView = findViewById(R.id.amapView); 
/ 执行 地 图 视图 的 创建 操作 
mMapView.onCreate(savedInstanceState); 
/ 先 隐藏 地 图 ， 待 定位 到 当前 城市 时 再 显示 
mMapView.setVisibility(View.INVISIBLE); 
mMapLayer mMapView.getMap(); / 从 地 图 视图 中 获取 地 图 图 层 
mMapLayer.setOnMapClickListener(this); // 给 地 图 图 层 设置 地 图 点 击 监听 器 
ImMapLayersetMyLocationEnabled(true); / 开启 定位 图 层 
mLocClient = new AMapLocationClient(this.getApplicationContext()); / 创建 一 个 定位 客户 端 
mLocClient.setLocationListener(new MyLocationListenner()); // 设置 定位 监听 器 
AMapLocationClientOption option = new AMapLocationClientOption(0); / 创建 定位 参数 对 象 
option.setLocationMode(AMapLocationMode.Battery_Saving); / 设置 省 电 的 定位 模式 
option.setNeedAddress(true); / 设置 true 才能 获得 详细 的 地 址 信息 
mLocClient.setLocationOption(option); / 给 定位 客户 端 设置 定位 参数 
mLocClient.startLocation0; / 命令 定位 客户 端 开始 定位 

hb 

// 定义 一 个 定位 监听 器 

public class MyLocationListenner implements AMapLocationListener { 
/ 在 接收 到 定位 消息 时 触发 
public void onLocationChanged(AMapLocation location) { 

// 如 果 地 图 视图 已 经 销毁 ， 则 不 再 处 理 新 接收 的 位 置 
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if (location 一 null || mMapView — null) { 
Teturn; 
} 
mLatitude = location.getLatitude(); / 获得 该 位 置 的 纬度 
mLongitude = location.getLongitude(); / 获得 该 位 置 的 经 度 
String position = String.format(" 当 前 位 置 : %s|%s|%s|%s|%s|%s|%s"， 
location.getProvince(), location.getCity(), 
location.getDistrict(), location.getStreet(), 
location.getStreetNum(), location.getAddress(), 
DateUtil.formatDate(location.getTime())); 
tv_loc_position.setText(position); 
if(isFirstLoc){ / 首次 定位 
isFirstLoc = false; 
LatLng ll=new LatLng(mLatitude, mLongitude)j; / 创建 一 个 经 纬度 对 象 
CameraUpdate update = CameraUpdateFactory.newLatLngZoom(ll, 12); 
mMapLayermoveCamera(update); / 设置 地 图 图 层 的 地 理 位 置 与 缩放 比例 
mMapView.setVisibility(View.VISIBLE); / 定位 到 当前 城市 时 再 显示 图 层 


| 
高 德 地 图 定位 与 显示 的 效果 如 图 15-19 所 示 ，, 展示 的 界面 是 笔者 所 在 城市 的 地 图 , 笔者 当 
前 所 处 的 位 置 在 地 图 正中 央 。 
2. POI 搜索 
高 德 地 图 搜索 POI 的 流程 与 百度 地 图 类 似 , 具体 代码 参见 本 书 的 下 载 资源 。POI 搜索 的 效 
果 如 图 15-20 和 图 15-21 所 示 。 其 中 ， 图 15-20 为 输入 关键 词 “ 公 园 ” 后 的 查询 结果 ; 点击 其 
中 某 个 标注 ， 标 注 上 方 弹出 小 窗口 ， 提 示 该 标注 代表 的 公园 信息 ， 如 图 15-21 所 示 。 


thirdsdk 








城市 中 搜索 ” ”开始 下 一 组 数据 
话 市 内 找 


城市 中 搜索 ” ”开始 下 一 组 数据 


| 在 福州 “市 内 找 公园 
| 


清除 标记 166-206 呈 | 及 夺 洛 看 市 村 区 孙 相 路 全 
反光 得 必 12018-05-24 15.09:49 


le Rh le 当前 位 置 ” 三 这 本 市 | 医大 苹 [ 区 和 
清除 标记 206 号 入 计 省 福 | 区 孙 相 路 站 166-206 生 二 娃 省 并 市 闪 楼 区 未 相 路 音 
i 2 05- 4 0 到 一 近 光 明 性 |2018-05-24 15:09:37 





了 9 
Lm 6 
5 Sp qi + 











5 、 


15-19 ”高 德 地 图 定位 到 当前 城市 图 153-20 ”高 德 地 图 的 POI 搜索 结果 图 15-21 点击 某 个 POI 弹出 标注 信息 
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3. 距离 与 面积 测量 


在 高 德 地 图 上 添加 标记 也 是 通过 调用 MapLayer 对 象 的 add*** 方 法 , 可 添加 的 标记 和 对 应 
的 方法 说 明 见 表 15-2。 


表 15-2 ”高 德 地 图 的 标记 说 明 




















高 德 地 图 的 标记 类 MapLayer 类 的 添加 方法 说 明 
CircleOptions addCircle 

MarkerOptions addMarker 

PolygonOptions addPolygon 多 边 形 
PolylineOptions addPolyline 线段 
TextOptions addText 文本 








使 用 高 德 地 图 测 距 与 测 面 积 的 效果 如 图 15-22 和 图 15-23 所 示 。 其 中 ， 图 15-22 展示 了 福 
州 火车 站 与 国家 SA 景区 三 坊 七 巷 的 测 距 结 果 ， 可 以 看 到 两 点 之 间距 离 4.0 千 米 。 另 外 ， 再 看 
看 测量 岛屿 面积 的 结果 ， 图 15-23 显示 闽 江 口 琅 岐 岛 的 面积 大 约 是 59 平方 公里 ， 与 官方 公布 
的 岛屿 陆地 面积 55 平方 公里 相差 不 远 。 














Thirdsdk 








城市 中 搜索 ”开始 下 一 组 数据 


在 市 内 找 


前 位 置 ， 神 迷 省 | 福州 市 喜 楼 区 | 孙 相 
Fe 王建 省 福州 市 鼓 本 区 丞相 咎 第 近 
La i 


开始 下 一 组 数据 


前 位 置 : 福建 省 蜡 州 市 苹 楼 区 | 未 相 
010 
尖 们 1482221893438 








图 15-22 高 德 地 图 的 距离 测量 结果 图 15-23 ”高 德 地 图 的 面积 测量 结果 





15.2 分享 SDK 


社会 化 分 享 指 的 是 用 户 通过 互联 网 这 个 媒介 把 文本 /图 片 /多 媒体 信息 分 享 到 该 用 户 的 交 
际 圈 ， 从 而 加 快 信息 传播 的 行为 。 对 于 App 来 说 ， 网 络 社区 虽 多 ， 但 用 户 量 足 够 大 的 就 那么 
几 个 ，App 的 社会 化 分 享 功能 抓 住 几 个 大 的 圈子 就 够 了 ， 比 如 QQ、 微 信 、QQ 空间 、 微 信 朋 
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友 圈 等 。 本 节 介 绍 QQ 分 享 与 微 信 分 享 的 实现 方案 。 











15.2.1 QQ 分 享 


QQ 好 友 分 享 与 QQ 空间 分 享 同属 QQ 互联 平台 上 的 QQ 分 享 ， 该 平台 的 网 址 是 
https://connect.qq.com/。 依 次 单 击 平台 首页 的 “文档 资料 ”一 左边 导航 栏 的 “SDK 及 资源 下 载 ” 
一 “SDK 下 载 页 面 ”， 进 入 QQ 分享 的 SDK 下 载 页 面 。 下 载 页 面 上 的 说 明 资料 比较 详细 ， 这 
里 主要 介绍 与 QQ 分 享 相关 的 方法 与 参数 。 

下 面 是 QQ 分 享用 到 的 Tencent 类 的 主要 方法 说 明 。 


15-3。 


QQShare 类 的 分 享 参数 
SHARE TO QQ KEY_TYPE 


PARAM_TARGET_URL 
PARAM_TITLE 
PARAM_SUMMARY 

SHARE TO_ QQ IMAGE URL 


createInstance: 根据 appid 创建 一 个 Tencent 实例 。 

login: QQ 账号 登录 。 该 方法 需 指 定 登录 回调 监听 器 IUiListener。 

setAccessToken: 设置 入 口令 牌 。 登录 成 功 后 设置 ， 即 完成 授权 动作 。 

setOpenld: 设置 开放 标识 。 登 录 成 功 后 设置 ， 即 完成 授权 动作 。 

getQQToken: 获取 QQ 登录 授权 的 令 牌 。 分 享 到 腾讯 微 博时 才 需 使 用 该 方法 。 
shareToQQ: 分 享 给 QQ 好 友 。 该 方法 需 指 定 分 享 参 数 , 分 享 参 数 的 取 值 说 明 见 表 15-3。 
shareToQzone: 分 享 到 QQ 空间 。 该 方法 需 指定 分 享 参数 ， 分 享 参数 的 取 值 说 明 见 表 


表 15-3 ”QQ 分 享 的 接口 参数 说 明 
说 明 
分 享 类 型 。 图 文 分 享 (普通 分 享 ) 填 
Tencent.SHARE TO QQ TYPE DEFAULT 
分 享 消息 被 点 击 后 的 跳 转 URL 
分 享 的 标题 
分 享 的 消息 摘要 
分 享 图 片 的 URL 或 本 地 路 径 





SHARE TO QQ APP NAME 





在 手机 QQ 顶部 的 “返回 ”按钮 文字 后 加 上 应 用 名 。 若 为 空 ， 则 “返回 ” 
按钮 保持 原样 


QQ 分 享 完 毕 后 可 能 收 不 到 回调 事件 ， 这 是 因为 有 的 手机 会 自动 回收 资源 。 要 想 避 免 该 问 
题 ， 得 重 写 Activity 页 面 的 onActivityResult 方法 ， 加 入 Tencent 类 的 onActivityResultData 方 


法 调用 ， 示 例 代码 如 下 : 


// 从 QQ 分 享 页 面 返回 时 触发 


protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (requestCode 一 Constants.REQUEST_ LOGIN || requestCode 一 Constants.REQUEST APPBAR) { 
/ 如 果 是 从 登录 页 面 返回 ， 则 通知 登录 监听 器 处 理 结果 
TencentonActivityResultData(requestCode, resultCode, data, ShareGridAdaptermLoginListenen; 
} else if (requestCode 一 Constants.REQUEST QQ SHARE 
||requestCode 一 ConstantsREQUEST QZONE SHARE) { 
// 如 果 是 从 分 享 页 面 返回 ， 则 通知 分 享 监听 器 处 理 结果 
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Tencent.onActivityResultData(requestCode, resultCode, data, ShareGridA dapter.mShareListener); 
! 
super.onActivityResult(requestCode, resultCode, data); 


} 


QQ 分 享 的 效果 如 图 15-24 一 图 15-27 所 示 。 其 中 , 图 15-24 为 待 分 享 信息 的 标题 与 内 容 文 
本 ; 点 击 分 享 按钮 弹出 分 享 渠道 窗口 ， 如 图 15-25 所 示 ， 当 前 支持 QQ 好 友 、QQ 空间 、 腾 讯 
微 博 3 个 渠道 的 分 享 ; 单 击 QQ 好 友 图 标 跳 转 到 发 送 页 面 ， 如 图 15-26 所 示 ， 可 在 此 选择 消息 
分 享 的 好 友 对 象 ; 选择 分 享 的 对 象 好 友 后 可 在 聊天 消息 窗口 看 到 分 享 内 容 ， 如 图 15-27 所 示 ， 
包含 分 享 的 标题 、 内 容 与 图 片 等 信息 。 


Thirdsdk 


分 训 人 :km 吏 | 四 因 国 


分 享 内 容 : 门 前 小 桥 下 ， 游 过 一 群 鸭 。 大 家 
快 来 数 一 数 ， 二 四 六 七 八 。 QQ 好 友 ”QQ 空间 ”腾讯 微 博 


分 享 到 QQ 取消 





图 15-24 待 分 享 的 消息 内 容 图 15-25 QQ 分 享 的 渠道 列表 


选择 好 友 


选择 群 聊 


发 起 多 人 聊天 





15-26 选择 分 享 的 好 友 对 象 图 15-27 分 享 完 成 的 聊天 消息 
15.2.2” 微 信 分 享 


尽管 微 信 与 QQ 都 是 腾讯 公司 开发 , 不 过 它们 各 自 有 自己 的 开放 平台 。 微 信 开 放 平台 的 网 
引 是 https://open.weixin.qq.com/， 在 平台 首页 依次 单 击 链接 “资源 中 心 ”一 左边 导航 栏 “ 资 源 
下 载 ” 一 “Android 资源 下 载 ”， 即 可 在 打开 的 页 面 中 下 载 开 发 工具 包 与 范例 代码 。 使 用 范例 
代码 演示 时 ， 注 意 修改 以 下 3 处 地 方 : 


1. 将 模块 的 开发 签名 文件 设置 为 demo 工程 自 带 的 debug.keystore 


打开 模块 的 编译 文件 build.gradle， 在 该 文件 的 android 节点 下 补充 签名 配置 ， 具 体 的 配置 
代码 如 下 : 
signingConfigs { 
debug { 
storeFile file("debug.keystore") 





a 
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2. 将 包 名 改 为 demo 工程 的 包 名 net.sourceforge.simcpux 


除了 AndroidManifest.xml 的 package 节点 值 需要 更 改 外 ， 还 要 修改 build.gradle 里 面 的 包 
名 配置 ， 即 将 applicationId 值 改 为 新 的 包 名 ， 具 体 的 配置 代码 如 下 : 


defaultConfig { 
applicationId "net.sourceforge.simcpux" 
minSdkVersion 16 
targetSdk Version 27 
VersionCode 1 
VersionName "1.0" 





i 
3. 在 AndroidManifest.xml 中 注册 微 信 分 享 的 回调 页 面 WXEntryActivity 


WXEntryActivity.java 文件 必须 位 于 “ 包 名 .wxapi” 这 个 包 下 面 ， 否 则 无 法 正确 收 到 微 信 
分 享 的 返回 结果 。 同 时 要 在 AndroidManifest.xml 中 注册 该 活动 页 面 ， 具 体 的 注册 代码 如 下 : 





<activity 
android:name="net.sourceforge.simcpux.wxapi. WXEntryActivity" 
android:configChanges="keyboardHiddenlorientation|screenSize" 
android:exported="true" 
android:screenOrientation="portrait" 
android:theme="(@android:style/Theme.Translucent.NoTitleBar" /> 
微 信 和 好友 分 享 与 微 信 朋 友 圈 分 享 统称 为 微 信 分 享 ， 主要 用 到 IWXAPI、 
SendMessageToWX.Req 和 WXMediaMessage 三 个 类 。 下 面 是 IWXAPI 的 常用 方法 说 明 。 
e@ createWXAPI: 创建 一 个 微 信 API 实例 。 当 传 入 的 appid 为 空 时 ,还 需 调 用 registerApp 
方法 进行 注册 ; 注册 完毕 后 再 传 入 appid， 此 时 获得 的 实例 才 可 进行 后 续 分 享 。 
eregisterApp: 注册 指定 的 appid。 
e@ sendReq: 发 送 分 享 请求 。 该 方法 的 参数 为 SendMessageToWX.Req 对 象 。 
下 面 是 SendMessageToWX.Req 的 常用 属性 说 明 。 
e@ _ transaction: 本 次 请 求 的 流水 。 用 于 标识 每 次 请 求 的 唯一 性 。 
e@ scene: 本 次 请 求 的 场景 。SendMessageToWX.Req.WXSceneSession 表示 分 享 给 微 信 好 
友 ，SendMessageToWX.Req.WXSceneTimeline 表示 分 享 到 朋友 园 。 
e@ message: 本 次 请 求 的 信息 。 该 方法 的 参数 为 WXMediaMessage 对 象 。 
下 面 是 WXMediaMessage 的 常用 属性 说 明 。 
e title: 分 享 的 标题 。 
e@ description: 分 享 的 内 容 。 
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e mediaObject: 分 享 的 媒体 信息 。 媒 体 信 息 的 对 象 说 明 见 表 15-4。 
e@ thumbData: 分 享 的 缩 略图 。 


表 15-4 ” 微 信 分 享 的 媒体 对 象 说 明 























媒体 对 象 类 说 明 
WXTextObject 文本 
WXImageObject 图 片 
WXWebpageObject 图 文 〈 既 有 文本 ， 又 有 图 片 ) 
WXMusicObject 音乐 
WXVideoObject 视频 
WXFileObject 文件 


QQ 分 享 与 微 信 分 享 的 使 用 代码 片段 如 下 : 


public void onItemClick(AdapterView<?> arg0, View argl, int arg2, long arg3) { 

ShareChanels item = mChannelList.get(arg2); 

mHandler.sendEmptyMessageDelayed(0, 1500); 

让 (item.channelType 一 WEIXIN) { / 分 享 给 微 信 好 友 
SendMessageToWX.Req req = new SendMessageToWX.Req():; 

// transaction 字段 用 于 唯一 标识 一 个 请 求 

Teq.transaction = "wx_share" + System.currentTimeMillis(); 
req.message = getWXMessage(); / 获得 指定 类 型 的 微 信 消息 
req.scene = SendMessage ToOWX.Req.WXSceneSession; 
mWeixinApi.sendReq(req); 

} else if (item.channelType 一 CIRCLE) { // 分 享 到 微 信 朋 友 圈 
SendMessageToWX.Req req = new SendMessageToWX.Req(); 
req.transaction = "wx_share" + System.currentTimeMillis(); 
req.message = getWXMessage(); / 获得 指定 类 型 的 微 信 消息 
req.scene = SendMessage ToOWX.Req.WXSceneTimeline; 
mWeixinApi.sendReq(req); 

} else if (item.channelType 一 QQ) { // 分 享 给 QQ 好 友 
mShareListener = new ShareQQListener(mContext, item.channelName); 
Bundle params = new Bundle(); 
params.putInt(QQShare.SHARE_TO_QQ KEY_TYPE, 

QQShare.SHARE TO QQ TYPE DEFAULT): 
params.putString(QQShare.SHARE_TO QQ _ TITLE, mTitle); 
params.putString(QQShare.SHARE_TO QQ SUMMARY, mContent); 
params.putString(QQShare.SHARE TO QQ TARGET URL, mUr; 
params.putString(QQShare.SHARE TO QQ IMAGE URL, mlmageUr)); 
params.putString(QQShare.SHARE TO QQ APP NAME, mContext.getPackageName()); 
mTencent.shareToQQ((Activity) mContext, params, mShareListener); 

} else if (item.channelType 一 QZONE) { / 分 享 到 QQ 空间 
mShareListener = new ShareQQListener(mContext, item.channelName); 
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ArrayList<String> urlList = new ArrayList<String>(); 
urlList.add(mImageUr)); 

Bundle params = new Bundle(); 
params.putInt(QzoneShare.SHARE TO QZONE KEY _TYPE, 


QzoneShare.SHARE TO QZONE TYPE IMAGE TEXT): 


params.putString(QzoneShare.SHARE TO QQ TITLE, mTitle); 
params.putString(QzoneShare.SHARE_ TO QQ SUMMARY, mContent); 
params.putString(QzoneShare.SHARE TO QQ TARGET URL., mUrD); 
params.putStringArrayList(QzoneShare.SHARE TO QQ IMAGE URL., urlList); 
mTencent.shareToQzone((Activity) mContext, params, mShareListener); 


// 获得 指定 类 型 的 微 信 消 息 
private WXMediaMessage getWXMessage() { 
WXMediaMessage msg = new WXMediaMessage(); 
if (!TextUtils.isEmpty(mTitle) &é& TextUtils.isEmpty(mImageUrD) { 


// 分 享 文本 消息 〈 文 本 非 空 ， 且 图 片 地 址 为 空 ) 
WXTextObject textObj = new WX TextObject(); 
textObj.text = mContent; 

msg.mediaObject = textObj; 

msg.title = mTitle; 

msg.description = mContent; 


} else if (TextUtils.isEmpty(mTitle) && !TextUtils.isEmpty(mImageUrD)) { 


// 分 享 图 片 消息 〈 文 本 为 空 ， 且 图 片 地 址 非 空 ) 

Bitmap bmp = BitmapFactory.decodeFile(mImageUrD; 

WXImageObject imgObj = new WXImageObject(bmp); 

msg.mediaObject = imgObj; 

Bitmap thumbBmp = Bitmap.createScaledBitmap(bmp, THUMB_SIZE, THUMB_SIZE, true); 
msg.thumbData = CacheUtil.bmpToByteArray(thumbBmp, true)) / 设置 缩 略图 


} else if (!TextUtils.isEmpty(mTitle) && !TextUtils.isEmpty(mImageUrl)) { 


1 


// 分 享 图 文 消息 (文本 非 空 ， 且 图 片 地 址 也 非 空 ) 

WXWebpageObject webpage = new WX WebpageObject(); 

webpage.webpageUrl = mUrl; 

msg.title = mTitle; 

msg.description = mContent; 

msg.mediaObject = webpage; 

Bitmap bmp = BitmapFactory.decodeFile(mImageUrD; 

Bitmap thumbBmp = Bitmap.createScaledBitmap(bmp, THUMB_SIZE, THUMB_SIZE, true); 
msg.thumbData = CacheUtil.bmpToByteArray(thumbBmp, true); / 设置 缩 略图 


return msg; 


public static ShareQQListener mShareListener // 声明 一 个 QQ 分 享 监听 器 对 象 
// 定义 一 个 QQ 分 享 监听 器 
private static class ShareQQListener implements IUiListener { 

private Context context; 

private String channeIName; // 分 享 渠道 名 称 


public Share QQListener(final Context context final String channelName) { 
this.context = context; 
this.channeIName = channelName; 

} 


// 在 分 享 成 功 时 触发 
public void onComplete(Object object) { 
Toast.makeText(context, channeIName + "分 享 完 成 :" + object.toString0， 
ToastLENGTH_ LONG).show(0); 


/ 在 分 享 失败 时 触发 
public void onError(UiError error) { 
Toast.makeText(context, channeIName + "分 享 失败 :" + errorerrorMessage， 
Toast.LENGTH_LONG).showO; 
} 
/ 在 分 享 取消 时 触发 
public void onCancelO { 
ToastmakeText(context channeIName + "分 享 取消 ", Toast.LENGTH_LONG).show(); 
训 


微 信 分 享 的 效果 如 图 15-28 一 图 15-31 所 示 。 其 中 ， 图 15-28 所 示 为 待 分 享 信息 的 标题 与 
内 容 文 本 ; 点 击 分 享 按钮 弹出 分 享 渠道 窗口 ， 如 图 15-29 所 示 ， 当 前 支持 包括 微 信 好 友 、 微 信 
朋友 圈 在 内 的 5 个 渠道 分 享 ; 点 击 微 信 好 友 图 标 跳 转 到 好 友 选 择 页 面 ， 如 图 15-30 所 示 , 可 在 
此 选择 消息 分 享 的 好 友 对 象 ， 选择 分 享 的 对 象 好 友 后 可 在 聊天 消息 窗口 看 到 分 享 内 容 ， 如 图 
15-31 所 示 ， 包 含 分 享 的 标题 、 内 容 与 图 片 等 信息 。 








分 享 标题 : | 别 看 我 只 是 一 只 半 ] 


分 享 内 容 : 喜 羊 羊 ， 美 羊 羊 ， 居 羊 羊 ， 沸 羊 
羊 ， 慢 羊 羊 ， 软 绵绵 ， 红 太 


人 
ny, 
微 信 好 友 微 信 朋 友 图 QQ 好 友 “QQ 空间 


分 享 到 沿 信 








图 15-28 ” 待 分 享 的 消息 内 容 图 15-29 ” 微 信 分 享 的 渠道 列表 
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别 看 我 只 是 一 只 羊 网 


创建 新 聊天 


最 近 碳 天 








图 15-30 选择 分 享 的 好 友 对 和 象 图 15-31 分 享 完成 的 聊天 消息 
15.3 ”支付 SDK 


第 三 方 支付 指 的 是 第 三 方 平台 与 各 银行 签约 ， 在 买方 与 卖方 之 间 实 现 中 介 担 保 ， 从 而 增 
强 支 付 交 易 的 安全 性 。 国 内 常用 的 支付 平台 主要 有 支付 宝 和 微 信 支付 。 据 2017 年 第 四 季度 的 
统计 数据 ， 支 付 宝 的 市 场 份额 为 $4.26%， 微 信 支 付 的 市 场 份额 为 38.15%。 也 就 是 说 ， 这 两 家 
垄断 了 92.41% 的 支付 市 场 份额 。 本 节 对 支付 宝 和 微 信 支付 分 别 进行 介绍 。 


15.3.1 支付 宝 支付 


因为 第 三 方 支付 只 是 一 个 中 介 ， 交 易 流 程 要 多 次 确认 ， 所 以 App 若 要 集成 支付 SDK， 需 
要 进行 以 下 处 理 : 

(1) 除了 作为 买方 的 用 户 自 己 拥有 支付 账号 ， 开 发 者 还 得 申请 作为 卖方 的 商户 账号 。 

(2) 支付 过 程 中 ， 虽然 允许 App 直接 与 第 三 方 支付 平台 通信 ,但 是 正常 要 有 自己 的 后 台 
服务 器 ， 由 服务 器 与 第 三 方 平台 进行 通信 。 这 样 做 的 好 处 是 ,一 方面 自己 后 台 掌 握 了 用 户 交易 
记录 , 做 账 有 依据 , 管理 也 方便 ; 另 一 方面 , 关键 交易 在 服务 器 处 理 , 减少 了 恶意 自 改 的 风险 。 

(3) 为 保证 信息 安全 ， 需 对 关键 数据 进行 加 密 处 理 ， 如 支付 宝 采用 RSA+BASE64 算法 ， 
微 信 支付 采用 MD5 算法 。 

支付 宝 的 官方 平台 是 蚂蚁 金 服 开放 平台 , 网 址 是 https://open.alipay.com/。 在 平台 首页 依次 
单 击 “ 文档 中 心 ”一 左边 导航 栏 的 资源 下 载 ” 一 “开发 工具 包 下 载 ” 一 “App 支付 DEMO&SDK ”， 
在 打开 的 页 面 中 点 击 下 载 支付 宝 SDK 及 其 DEMO 工程 。 

另外 ， 申 请 商户 账号 需要 创建 测试 应 用 ， 在 蚂蚁 金 服 平台 登录 成 功 后 ， 依 次 单 击 “ 研 发 
管理 ”一 “创建 应 用 ”, 填写 应 用 相关 信息 ， 提 交 成 功 后 返回 应 用 列表 页 面 。 然 后 查看 应 用 的 
详情 页 ， 单 击 “ 应 用 环境 ”链接 ， 在 环境 页 面 设 置 RSA 密 钥 ， 如 图 15-32 所 示 。 记 下 该 应 用 
的 APPID， 后 面 会 用 到 。 

集成 支付 宝 SDK 比较 简单 ， 除 了 必要 的 权限 外 ， 无 须 修改 AndroidManifest.xml，JAR 包 
也 只 要 导入 alipaySdk-***.jar 即 可 。 前 面 商户 账号 的 申请 信息 有 几 个 会 在 代码 中 体现 ， 包 括 商 
户 收 款 账 号 (开发 者 的 支付 宝 账号 ) 、 商 户 的 合作 编号 〈 测 试 应 用 的 APPID) 、 商 户 的 RSA 
私 钥 〈 在 应 用 环境 页 面 中 设置 的 RSA 密 钥 ) 。 
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第 三 方 应 用 是 吧 


pFID: 2016122004467754 





图 15-32 支付宝 测 试 应 用 的 环境 设置 页 面 
使 用 支付 宝 SDK 的 交易 流程 大 致 如 下 : 


(1) 按照 指定 格式 封装 好 交易 信息 。 

(2) 对 交易 信息 进行 RSA 加 密 与 URL 编码 。 

(3) 调用 支付 接口 , 传 入 加 密 好 的 信息 串 〈 这 步 要 另 开 线程 处 理 , 不 能 放 在 UI 线程 中 ) 。 
(4) 支付 宝 SDK 在 界面 下 方 弹出 支付 窗口 ， 用 户 输入 支付 账号 信息 ， 提 交 支 付 。 

(5) 收 到 支付 完成 的 结果 ， 判 断 支付 状态 是 成 功 还 是 失败 ， 并 做 相应 的 后 续 处 理 。 


具体 的 编码 实现 方面 ,支付 宝 官方 的 DEMO 工程 采用 了 Thread+Handler 的 异步 处 理 模式 ， 
不 过 该 模式 要 把 线程 代码 写 在 Activity 页 面 中 ,不 便 管 理 与 后 续 维护 ， 因 此 笔者 的 演示 代码 将 
其 改造 为 AsyncTask 方式 ， 详 细 代码 参见 本 书 附 录 源 码 thirdsdk 模块 的 AlipayTask.java。 

支付 宝 SDK 的 演示 效果 如 图 15-33 和 图 15-34 所 示 。 其 中 ， 图 15-33 所 示 为 待 付费 的 商品 
详情 ， 点 击 “ 支 付 宝 支付 ”按钮 ， 页 面 下 方 弹出 对 话 框 ， 等 待 用 户 确认 付款 ， 如 图 15-34 所 示 。 





四 确认 付款 


¥0.01 


订单 信息 大 白 免 奶 糖 


付款 方式 交通 银行 信用 卡 (6327) 


商品 名 称 : | 大白 免 奶 糖 


商品 描述 : 中 国 驰名 商标 ， 畅 销 全 球 一 百 多 
个 国家 和 地 区 。 


商品 价格 : ,0.01 元 


a 


图 15-33 待 支付 的 商品 信息 15-34 ”支付 宝 的 付款 弹 窗 
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15.3.2 ” 微 信 支付 


微 信 支付 的 官方 平台 是 微 信 开放 平台 ， 网 址 是 https://open.weixin.qq.com/。 在 平台 首页 依 
次 单 击 “ 资 源 中 心 ”一 左边 导航 栏 的 “资源 下 载 ” 一 “Android 资源 下 载 ”， 即 可 在 打开 的 页 
面 中 下 载 开发 工具 包 与 范例 代码 ， 注 意 这 里 的 开发 包 libammsdk.jar 同时 集成 了 微 信 分 享 与 微 
信 支 付 的 SDK。 

使 用 微 信 支 付 也 需 先 申 请 测试 应 用 ， 在 微 信 开 放 平台 登录 成 功 后 ， 依 次 单 击 链 接 “ 管 理 
中 心 ” 一 “创建 移动 应 用 ”， 填写 应 用 相关 信息 ， 提 交 成功 后 返回 应 用 列表 页 面 。 然 后 查看 应 
用 的 详情 页 , 在 接口 信息 栏目 中 发 现 默认 已 获得 微 信 分 享 的 权限 , 而 微 信 支 付 权限 需要 另外 申 
请 开通 ， 如 图 15-35 所 示 。 

因为 个 人 开发 者 无 法 申请 微 信 支 付 功 能 ， 所 以 只 能 使 用 官方 DEMO 工程 里 的 测试 账号 进 
行 演 示 。 由 于 微 信 支 付 与 微 信 分 享 在 同一 个 开发 包 中 ， 因 此 集成 步 又 与 微 信 分 享 大 致 相同 , 需 




















持 口 信息 


后 口 名 称 傍 口 介 噶 答 吕 多吉 柄 作 


分 字 到 朋友 加 





乱用 因 舍 由 全 于 APp 或 吉 河 站 二 生 





5 镶 取 卡 尖 收 入 向 信 卡 包 详 千 二 二 后 








和 名品 区 得 汪 训 识别 、 国 尖 识 到 ， 江 六 理 和 和 模式 识 全 部 力 < 
图 15-35 ” 微 信 平台 测试 应 用 的 接口 信息 页 面 


(1) 支付 结果 页 面 的 代码 WXPayEntryActivity.java 必须 放 在 “ 包 名 .wxapi” 这 个 包 下 面 。 
另外 ，AndroidManifestxml 也 要 补充 注册 ，activity 节点 的 注册 配置 举例 如 下 : 
<!- 微 信 支 付 回调 页 面 -> 
<activity 
android:name="net.sourceforge.simcpux.wxapi. WXPayEntryActivity" 
android:exported="true" 
android:launchMode="singleTop" > 
</activity> 
(2) 确保 测试 设备 安装 了 微 信 , 并 且 已 有 默认 登录 的 微 信和 账号。 如果 设 备 上 没有 安装 微 信 ， 
那么 在 调用 微 信 支付 时 会 报错 Failed to find provider info for com.tencent.mm.sdk.plugin.provider。 
使 用 微 信 支付 的 交易 流程 大 致 如 下 : 
(1) 使 用 开发 者 申请 到 的 APP_ID 和 APP_SECRET 向 微 信 平台 请 求 获取 入 口令 牌 。 
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(2) 封装 订单 信息 〈 使 用 开发 者 申请 到 的 PARTNER_ID 和 PARTNER_KEY) ， 并 对 订 
单 信息 进行 MD5 摘要 处 理 。 

(3) 把 加 密 后 的 订单 与 入 口令 牌 发 给 微 信 平 台 ， 生 成 预支 付 订单 ， 返 回 预付 订单 编号 。 

(4) 重新 封装 订单 信息 ， 加 上 预付 订单 编号 ， 向 微 信 平台 发 起 支付 交易 。 

(5) 微 信 SDK 跳 到 微 信 支 付 页 面 ， 用 户 输入 支付 账号 信息 ， 提 交 支 付 。 

(6) 支付 完成 ， 回 到 支付 结果 页 面 ， 根 据 处 理 结果 进行 回调 操作 。 


编码 方面 ， 微 信 支 付 与 支付 宝 一 样 建议 把 支付 操作 交 给 商户 的 后 台 服 务 器 运行 ， 不 要 由 
App 直接 与 支付 平台 进行 付款 交易 , 演示 工程 里 的 测试 代码 只 是 为 了 说 明 交互 的 流程 , 不 可 作 
为 正式 支付 应 用 。 

微 信 支付 SDK 的 演示 效果 如 图 15-36 和 图 15-37 所 示 。 其 中 ， 图 15-36 为 待 付费 的 商品 
详情 , 点 击 “ 微 信 支 付 ” 按钮 后 ， 跳 转 到 微 信 支 付 的 交易 页 面 ， 等 待 用 户 确认 付款 ， 如 图 15-38 
所 示 。 





je 











weixin 







¥0.01 


自助 商户 测试 帐户 


立即 支付 






商品 名 称 : | 周 干 妈 鳞 淆 
商品 描述 :| 中 国名 牌 称号 ， 焉 果 仁 眼 中 来 自 
中 国 的 进口 夺 侈 品 。 


商品 价格 : |0.01 元 
微 信 支 付 








图 15-36 ” 待 支付 的 商品 信息 图 15-37 微 信 支 付 的 付款 页 面 
15.4 语音 SDK 


如 今 ， 越 来 越 多 App 用 到 了 语音 播报 功能 ， 如 地 图 导航 、 天 气 预报 、 文 字 阅 读 、 口 语 训 
练 等 。 语音 技术 主要 分 为 两 块 ， 一 块 是 语音 转 文 字 ， 即 语音 识别 ; 另 一 块 是 文字 转 语音 ， 即 语 
音 合成 。 国 内 的 语音 服务 提供 商 主要 有 两 家 : 讯 飞 语音 和 百度 语音 。 本 节 主 要 介绍 讯 飞 语音 的 
语音 识别 和 语音 合成 功能 。 


15.4.1 文字 转 语音 TextToSpeech 


语音 播报 的 本 质 是 将 书面 文字 转换 成 自然 语言 的 音频 流 ， 这 个 转换 操作 在 计算 机 术语 中 
被 称 作 语 音 合成 。 语 音 合成 通常 也 简称 为 TTS， 即 TextToSpeech 〈 从 文本 到 语言 ) 。 语 音 合 
成 技术 把 文字 智能 地 转化 为 自然 语音 流 , 为 了 避免 机 械 合 成 的 采 板 和 停顿 感 , 语音 引擎 还 得 对 
语音 流 进行 平滑 处 理 ， 才 能 确保 输出 的 语音 音律 流畅 、 感 觉 自 然 。 

Android 从 1.6 开始 ， 就 内 置 了 语音 合成 引擎 ， 即 “Pico TTS”。 该 引擎 支持 英语 、 法 语 、 
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德语 、 意 大 利 语 ， 但 不 支持 中 文 ， 幸 好 Android 从 4.0 开始 允许 接 入 第 三 方 的 语音 引擎 ， 因 此 
只 要 在 设备 上 安装 了 中 文 引 擎 ， 就 能 在 代码 中 使 用 中 文 语音 合成 服务 。 现 在 国产 手机 大 都 对 
Android 进行 了 深度 定制 ， 部 分 手机 在 出 厂 前 已 经 集成 了 第 三 方 的 中 文 引 擎 ， 辟 如 图 15-38 所 
示 的 联想 手机 内 置 了 联想 语音 合成 服务 ， 图 15-39 所 示 的 小 米 手机 内 置 了 度 秘 语音 引擎 。 


《< ”文字 转 语音 (TTS) 输出 《 首选 引 敬 


首选 引擎 








Pico TTS 
〇 联想 语音 合成 服务 


》 度 秘 语音 引擎 3.0 





OO PicoTTS 


图 15-38 ”联想 手机 内 置 的 语音 引擎 15-39 小米 手机 内 置 的 语音 引擎 


不 管 是 系统 自 带 的 Pico 引擎 ， 还 是 手机 厂商 集成 的 中 文 引擎 ， 都 支持 通过 系统 的 API 进 
行文 本 的 语音 合成 。 Android 的 语音 合成 工具 名 叫 TextToSpeech, 下 面 是 该 类 常用 的 方法 说 明 。 


@ 构造 函数 : 第 二 个 参数 设置 语音 监听 器 OnInitListener ( 需 重 写 监 听 器 的 onInit 方法 ) 。 
第 三 个 参数 设置 语音 引擎 ， 默 认 是 系统 自 带 的 Pico， 要 获取 系统 支持 的 所 有 引擎 可 调 
用 getEngines 方法 。 

esetLanguage: 设置 语言 。 其 中 英语 为 Locale.ENGLISH， 法 语 为 Locale.FRENCH， 德 
语 为 Locale.GERMAN， 意 大 利 语 为 Locale.ITALIAN， 汉 语 普通 话 为 Locale.CHINA。 
该 方法 的 返回 值 有 4 个， 具体 说 明 参 见 表 15-5。 


表 15-5 ”setLanguage 方 法 的 返回 值 说 明 


TextToSpeech 类 的 返回 值 说 明 
LANG_COUNTRY_AVAILABLE 该 国 的 语言 可 用 
LANG_AVAILABLE 语言 可 用 
LANG_MISSING_DATA 缺少 数据 
LANG_NOT_SUPPORTED 暂 不 支持 


setSpeechRate: 设置 语 速 。1.0 为 正常 语 速 ; 0.5 为 慢 一 半 的 语 速 ; 2.0 为 快 一 倍 的 语 速 。 
setPitch: 设置 音调 。1.0 表示 正常 音调 ; 低 于 1.0 的 为 低音 ; 高 于 1.0 的 为 高 音 。 
speak: 开始 对 指定 文本 进行 语音 朗读 。 

synthesizeToFile: 把 指定 文本 的 朗读 语音 输出 到 文件 。 

stop: 停止 朗读 。 

shutdown: 关闭 语音 引擎 。 

isSpeaking: 判断 是 否 在 语音 朗读 。 

getLanguage: 获取 当前 的 语言 。 

getCurrentEngine: 获取 当前 的 语音 引擎 。 

getEngines: 获取 系统 支持 的 所 有 语音 引擎 。 


TextToSpeech 类 的 方法 不 多 ， 可 是 用 起 来 颇 费 一 番 周 折 ， 要 想 实现 语音 播报 功能 ， 得 按 








726 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


照 以 下 流程 操作 : 调用 带 两 个 参数 的 构造 函数 进行 初始 化 一 调用 getEngines 方法 获得 系统 支持 
的 语音 引擎 队列 一 调用 带 三 个 参数 的 构造 函数 初始 化 指定 引擎 一 调用 setLanguage 方法 设置 该 
引擎 支持 的 语言 一 最 后 调用 speak 方法 开始 朗读 动作 。 

这 里 面 的 关键 是 怎么 判断 每 个 语音 引擎 到 底 都 支持 哪儿 种 语言 ， 由 于 系统 无 法 直接 获取 
某 引擎 的 有 效 语 言 ， 因 此 只 能 轮流 调用 setLanguage 方法 分 别 检查 每 个 语言 ， 返 回 值 为 
TextToSpeech.LANG COUNTRY_AVAILABLE 或 者 TextToSpeech.LANG AVAILABLE, 都 表 
示 当 前 引擎 支持 该 语言 。 根据 以 上 思路 编码 ， 即 可 获得 指定 引擎 对 各 种 语言 的 支持 程度 ,如 图 
15-40 所 示 ， 这 是 Pico 引擎 所 支持 的 语言 列表 ; 又 如 图 15-41 所 示 ， 这 是 度 秘 语音 引擎 所 支持 
的 语言 列表 。 





thirdsdk thirdsdk 
请 选择 语音 引擎 Pico TTS 请 选择 语音 引擎 度 秘 语音 引擎 3.0 
语言 名 称 态 摘 ; i k 状态 描述 
英语 i 正常 使 用 


法 语 法 i 暂 不 支持 
德语 暂 不 支持 
意大利 语 意大利 i 暂 不 支持 
汉语 普通 话 汉语 普通 i 正常 使 用 





15-40 Pico 引擎 支持 的 语言 列表 图 15-41 度 秘 引擎 支持 的 语言 列表 
既然 明确 了 一 个 引擎 能 够 支持 哪些 语言 ， 接 下 来 就 可 以 大 胆 设置 朗读 的 语音 了 。 当 然 ， 
设置 好 了 语言 , 还 得 提供 对 应 的 文字 才 行 ， 否则 用 英语 去 朗读 一 段 中 文 , 或 者 让 汉语 去 朗读 一 
段 英文 ， 其 结果 无 异 于 鸡 同 鸭 讲 。 下 面 是 一 个 语音 播报 页 面 的 完整 代码 示例 : 
public class TtsReadActivity extends AppCompatActivity implements OnClickListener { 
private TextToSpeech mSpeech; / 声明 一 个 文字 转 语音 对 象 
private EditText et_tts; 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_tts_read); 
et tts = findViewById(R.id.et_ tts); 
findViewById(R.id.btn_read).setOnClickListener(this); 
// 创建 一 个 文字 转 语音 对 象 ， 初 始 化 结果 在 监听 器 TTSListener 中 返回 
mSpeech = new TextToSpeech(TtsReadActivity.this, new TTSListener()); 

} 


private List<TextToSpeech.EngineInfo> mEngineList; / 语音 引擎 队列 
// 定义 一 个 文字 转 语音 的 初始 化 监听 器 
private class TTSListener implements TextToSpeech.OnlInitListener { 
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/ 在 初始 化 完成 时 触发 
public void onInit(int status) { 
让 (status 一 TextToSpeech.SUCCESS) { // 初始 化 成 功 
让 (mEngineList 一 null) { / 首次 初始 化 
/ 获取 系统 支持 的 所 有 语音 引擎 
mEngineList = mSpeech.getEngines(); 
initEngineSpinner();// 初始 化 语音 引擎 下 拉 框 
} 
initLanguageSpinner(); // 初始 化 语言 下 拉 框 


1 


/ 初始 化 语音 引擎 下 拉 框 
private void initEngineSpinner() { 
String[] engineArray = new String[mEngineList.size()]; 
for(int i=0; i<mEngineL ist.size(); i++) { 
engineArray[i] =mEngineList.get(?).label; 
} 
ArrayAdapter<String> engineAdapter =new ArrayAdapter<String>(this, 
R.layout.item _select, engineArray); 
engineAdapter.setDropDownViewResource(R.layout.item_select); 
Spinner sp =findViewById(R.id.sp_engine); 
sp.setPrompt(" 请 选择 语音 引擎 "); 
sp.setAdapter(engineA dapter); 
sp.setOnltemSelectedListener(new EngineSelectedListener()); 
sp.setSelection(0); 
b 


private class EngineSelectedListener implements OnltemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
recycleSpeech();// 回收 文字 转 语 音 对 象 
// 创建 指定 语音 引擎 的 文字 转 语音 对 象 
mSpeech = new TextToSpeech(TtsReadActivity.this, new TTSListener(), 
mEngineList.get(arg2).name); 
} 


public void onNothingSelected(AdapterView<?> arg0) {} 
' 


// 回收 文字 转 语音 对 象 
Private void recycleSpeech() { 
if (mSpeech !=nulD) { 
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mSpeech stop(); / 停止 文字 转 语音 
ImSpeech.shutdown(); / 关闭 文字 转 语音 
mSpeech =mull; 


private String[] mLanguageArray = {" 英 语 ", "法 语 ", "德语 ", "意大利 语 ", "汉语 普通 话 " }; 
private Locale[] mLocaleArray = { 
Locale.ENGLISH, Locale.FRENCH, Locale.GERMAN, Locale.ITALIAN, Locale.CHINA }; 
private String[] mValidLanguageArray; / 当前 引擎 支持 的 语言 名 称 数组 
private Locale[] mValidLocaleArray; / 当前 引擎 支持 的 语言 类 型 数组 
private String mTextEN = "hello world. This is a TTS demo."; 
private String mTextCN = " 离 离 原 上 草 ， 一 岁 一 枯 荣 。 野 火烧 不 尽 ， 春 风 吹 又 生 。"; 


1/ 初始 化 语言 下 拉 框 
private void initLanguageSpinner() { 
ArrayList<Language> languageList = new ArrayList<Language>(); 
// 下 面 遍历 语言 数组 ， 从 中 挑选 出 当前 引擎 所 支持 的 语言 队列 
for (int i=0; i <mLanguageArray.length; i++) { 
/ 设置 朗读 语言 。 通 过 检查 函数 的 返回 值 ， 判 断 引擎 是 否 支 持 该 语言 
int result = mSpeech.setLanguage(mLocaleArray[i]); 
if (result = TextToSpeech.LANG _ MISSING DATA 
&& result != TextToSpeech.LANG_NOT_SUPPORTED) { // 语言 可 用 
Language language = new Language(mLanguageArray[i], mLocaleArray[i]); 
languageList.add(language); 


} 
mValidLanguageArray = new String[languageList.size()]; 
mValidLocaleArray = new Locale[languageListsize0]; 
for(int i=0; i<languageL ist.sizeO; i++) { 
mValidLanguageArray[i] = languageList.get(i).name; 
mValidLocaleArray[i] = languageList.get(i).locale; 
l 
// 下 面 初始 化 语言 下 拉 框 
ArrayAdapter<String> languageAdapter = new ArrayAdapter<String>(this, 
R.layout.item _select, mValidLanguageArray); 
languageAdapter.setDropDownViewResource(R.layout.item_select); 
Spinner sp = findViewById(R.id.sp_language); 
sp.setPrompt(" 请 选择 朗读 语言 "); 
sp.setAdapter(languageAdapter); 
sp.setOnltemSelectedListener(new LanguageSelectedListener()); 
sp.setSelection(0); 
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Private class LanguageSelectedListener implements OnltemSelectedListener { 
public void onItemSelected(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
if (mValidLocaleArray[arg2]==Locale.CHINA) { // 汉语 
et tts.setText(mTextCN); 
}else { // 其 他 语言 
et tts.setText(mTextEN); 
} 
// 设置 选中 的 朗读 语言 
mSpeech.setLanguage(mValidLocaleArray[arg2]); 
} 


public void onNothingSelected(AdapterView<?> arg0) {} 
! 


public void onClick(View v) { 
if(v.getId0 一 R.id.btn read) { 
String content = et_tts.getText().toString(); 
/ 开始 朗读 指定 文本 
int result = mSpeech.speak(content, TextToSpeech.QUEUE_FLUSH, null); 
String desc = String.format(" 朗 读 %s", result 一 TextToSpeech.SUCCESS?" 成 功 ":" 失 败 "); 
Toast.makeText(TtsReadActivity.this, desc, Toast.LENGTH_SHORT).show(); 


} 

语音 播报 的 效果 如 图 15-42 和 图 15-43 所 示 ， 因 为 朗诵 的 声音 无 法 在 截图 上 反映 出 来 ， 所 
以 姑且 只 见 其 人 不 闻 其 声 啦 。 其 中 图 15-42 为 正在 朗诵 英文 时 的 界面 ， 图 15-43 为 正在 朗诵 中 
文 时 的 界面 。 


























系统 自 带 的 语音 合成 示例 系统 自 带 的 语音 合成 示例 
度 秘 语音 引擎 3.0 ~ 英语 号 度 秘 语音 引擎 3.0 ~ 汉语 普通 话 入 
ello world. This is a TTS demo. 离 离 原 上 草 , 一 岁 一 枯 荣 。 野火 烧 不 尽 ， 
春风 吹 又 生 。 
开始 朗读 开始 朗读 
图 15-42 正在 朗诵 英文 时 的 界面 图 15-43 ”正在 朗诵 中 文 时 的 界面 


上 一 小 节 提 到 ， 只 要 安装 了 中 文 引擎 ， 就 能 在 TextToSpeech 中 使 用 中 文 语音 ， 可 是 并 非 
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所 有 手机 都 集成 了 中 文 引擎 ， 况 且 TextToSpeech 难以 个 性 化 定制 ， 连 更 换 男声 和 女声 都 做 不 
到 ， 媚 论 其 他 。 可 行 的 办 法 是 在 自己 的 App 中 集成 语音 SDK， 目 前 中 文 环境 常见 的 语音 SDK 
主要 有 科大 讯 飞 、 百 度 语音 、 捷 通 华声 、 云 知 声 等 ， 接 下 来 的 两 小 节 就 以 讯 飞 语音 为 例 ， 介 绍 
如 何在 App 开发 中 运用 中 文 的 语音 识别 及 语音 合成 技术 。 

讯 飞 语音 的 开放 平台 网 址 是 http://www.xfyun.cn/。 在 平台 首页 单 击 “SDK 下 载 ” 链 接 ， 
在 下 载 页 面 选择 服务 (语音 听写 和 在 线 语 音 合 成 ) 、 平 台 (选择 Android) 、 选 择 应 用 (一 
始 要 创建 新 应 用 ) ， 然 后 单 击 “ 下 载 SDK” 按 钮 ， 等 待 下 载 开发 包 。 

注意 讯 飞 语音 在 下 载 SDK 前 要 先 创建 应 用 ， 不 妨 把 应 用 创建 操作 提 到 前 面 来 。 开 发 者 在 
讯 飞 开放 平台 注册 并 成 功 登 录 后 ， 依 次 单 击 链接 “控制 台 ” 一 左边 导航 栏 的 “创建 新 应 用 ”， 
打开 应 用 创建 页 面 ， 如 图 15-44 所 示 。 














DMEFMTE ~ 


:= 
3 。 志 用 天池 司 -基地 


| 





图 15-44 讯 飞 语音 的 应 用 创建 页 面 


填写 各 项 应 用 信息 ， 并 勾 选 “我 已 阅读 并 接受 ***”， 然 后 单 击 “ 提 交 ” 按 钮 ， 回 到 应 用 
信息 页 面 ， 如 图 15-45 所 示 。 


珊 讯 。 SDKT 载 。 资料 库 ” ”合作 与 生态 ” ”论坛 





我 9 浊音 去 首页 血 第 三 方 应 用 Appid : :sezzz 创建 时间 ，2016 jz 分 类 ;后 # 了 二 向 要 名 
应 用 管理 
| 0 swan 
后 协作 上 用 


您 还 未 开通 任何 服务 立即 开通 





图 15-45 ”测试 应 用 的 初始 信息 页 面 


应 用 刚 创建 完 默认 未 开通 任何 服务 ， 因 此 需要 单 击 应 用 页 面 上 的 “立即 开通 ”链接 ， 弹 
出 选择 开通 业务 窗口 ， 如 图 15-46 所 示 。 

首先 勾 选 “语音 听写 ”， 单 击 “ 确 定 ” 按 钮 开通 语音 听写 服务 。 因 为 每 次 只 能 开通 一 项 
服务 ， 所 以 回 到 应 用 信息 页 面 后 ， 单 击 “ 开 通 更 多 服务 ”链接 ， 再 次 打开 业务 开通 窗口 ， 然 后 
勾 选 “在 线 语音 合成 ”， 并 单 击 “ 确 定 ” 按 钮 开通 语音 合成 服务 ， 如 图 15-47 所 示 。 
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图 15-46 开通 语音 识别 服务 图 15-47 开通 语音 合成 服务 


语音 听写 和 语音 合成 服务 都 申请 开通 后 ， 回 到 应 用 信息 页 面 ， 即 可 看 到 该 测试 应 用 的 已 
开通 服务 列表 已 包含 这 两 项 ， 如 图 15-48 所 示 。 同 时 记 下 测试 应 用 的 Appid， 后 面 会 用 到 。 





DMEFMTE wams. Wena- wih sokFR HE fFS 和 态 ” 论坛 


应 用 管理 


已 开通 的 服务 


口 我 的 应 用 
FE a 
ee 图 加 上 


十 创建 新 占用 FRR 生生 久 本 。 在 者 症 侣 克 。 开通 更 人 各 各 


15-48 ”开通 服务 后 的 应 用 信息 页 面 
集成 讯 飞 语音 SDK 需要 注意 以 下 几 点 : 
(1) 将 Msc.jar、Sunflower.jar 导入 libs 目录 , 将 libmsc.so 整个 目录 导入 src/main/jniLibs。 
(注意 这 些 文件 必须 来 自 对 应 的 SDK， 如 果 用 别 的 SDK， 运行 就 会 报错 “用 户 校 验 失败 ”)》。 
(2) 自 定义 一 个 Application 类 ， 在 onCreate 函数 中 加 入 以 下 代码 ， 注 意 appid 值 为 创建 
测试 应 用 时 分 配 到 的 Appid: 
/ 设置 在 讯 飞 平台 上 申请 的 应 用 编号 
SpeechUtility.createUtility(MainApplication.this, "appid=58561727"); 
(3) 在 AndroidManifestxml 中 加 入 必要 的 权限 和 自 定义 的 Application 类 。 
(4) 如 果 用 到 RecognizerDialog 控件 , 就 要 把 DEMO 工程 assets 目录 下 的 文件 复制 过 
来 。 
(5) 在 混淆 打包 时 需要 添加 -keep class com.iflytek.**{*;}， 避 免 混淆 导致 SDK 不 可 用 。 
讯 飞 SDK 的 语音 识别 功能 主要 通过 SpeechRecognizer 类 实现 ， 有 以 下 常用 方法 。 


e@ createRecognizer: 创建 语音 识别 对 象 。 
esetParameter: 设置 语音 识别 的 参数 。 语 音 识别 的 参数 说 明 见 表 15-6。 
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表 15-6 ”语音 识别 的 参数 说 明 


SpeechConstant 类 的 识别 参数 | 说 明 


























ENGINE TYPE 设置 听写 引擎 。 TYPE_LOCAL 表示 本 地 ，TYPE_CLOUD 表示 云端 ， 
TYPE_MIX 表示 混合 

RESULT_TYPE 设置 返回 结果 格式 。 比 如 JSON 表示 JSON 格式 

LANGUAGE 设置 语言 。zh_cn 表示 中 文 ，en_us 表示 英文 

ACCENT 设置 方言 。mandarin 表示 普通 话 ，cantonese 表示 粤语 ，henanese 表示 河南 
话 

VAD BOS 设置 静音 超时 时 间 ， 即 用 户 多 长 时 间 不 说 话 就 当 作 超时 处 理 

VAD_EOS 设置 静音 检测 时 间 ， 即 用 户 停止 说 话 多 长 时 间 内 就 自动 停止 录音 

ASR_PTT 设置 标点 符号 。0 表示 返回 结果 无 标点 ，1 表示 返回 结果 有 标点 


AUDIO_FORMAT 
ASR_AUDIO_PATH 
AUDIO_SOURCE 


ASR_SOURCE_PATH 


设置 音频 的 保存 格式 

设置 音频 的 保存 路 径 

设置 音频 的 来 源 。-1 表示 音频 流 ， 与 writeAudio 配合 使 用 ，-2 表示 外 部 
文件 ， 同 时 设置 ASR_SOURCE _PATH 指定 文件 路 径 

设置 外 部 音频 文件 的 路 径 


startListening: 开始 监听 语音 。 参 数 为 RecognizerListener 对 象 ， 该 对 象 需要 重 写 以 下 方 


> onBeginOfSpeech: 内 部 录音 机 已 准备 好 ， 用 户 可 以 开始 语音 输入 。 


> 
于 
> 
> 


> 


onError: 错误 码 10118 ( 您 没有 说 话 )， 可 能 是 录音 机 权限 被 禁 ， 需 要 提示 用 户 打开 应 


onEndOfSpeech: 检测 到 了 语音 的 尾 端 点 ， 已 经 进入 识别 过 程 ， 不 再 接收 语音 输入 。 
onResult: 识别 结束 ， 返 回 结果 串 。 

onVolumeChanged: 语音 输入 过 程 中 的 音量 大 小 变化 。 

onEvent: 事件 处 理 ， 一 般 是 业务 出 错 等 异常 。 


stopListening: 结束 监听 语音 。 
writeAudio: 把 指定 的 音频 流 作为 语音 输入 。 


cancel: 取消 监听 。 


destroy: 回收 语音 识别 对 象 。 

语音 识别 的 演示 效果 如 图 15-49 和 图 15-50 所 示 。 其 中 , 图 15-49 为 点 击 “ 开 始 ” 按 钮 后 ， 
测试 App 正在 倾听 用 户 朗 读 时 的 界面 ; 朗读 完毕 ， 语 音 SDK 对 音频 流 进行 识别 处 理 ， 并 把 语 
音 识 别 后 的 文本 内 容 显示 在 页 面 上 ， 如 图 15-50 所 示 。 
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讯 飞 语音 识别 示例 。 设置 
白 日 依 山 尽 ， 黄 河 入 海流 ， 欲 穷 二 里 
目 ， 更 上 一 层 楼 。 


开始 识别 。。 停止 识别 。。 取 济 识别 








识别 音频 流 
15-49 测试 App 正在 倾听 用 户 说 话 15-50 测试 App 显示 语音 识别 的 文本 
15.4.3 ”语音 合 
语音 合成 和 语音 识别 功能 在 同一 个 开发 包 中 ， 只 需 一 次 集成 ， 无 须 重复 。 
讯 飞 SDK 的 语音 合成 功能 主要 通过 SpeechSynthesizer 类 实现 ， 有 以 下 常用 方法 。 


@ createSynthesizer: 创建 语音 合成 对 象 。 
esetParameter: 设置 语音 合成 的 参数 。 语 音 合 成 的 参数 说 明 见 表 15-7。 


表 15-7 ”语音 合成 的 参数 说 明 
SpeechConstant 类 的 合成 参数 | 说 明 

















ENGINE_TYPE 设置 合成 引擎 。TYPE_LOCAL 表示 本 地 ，TYPE_CLOUD 表示 云端 ， 
TYPE_MIX 表示 混合 

VOICE_ NAME 设置 朗读 者 。 默 认 xiaoyan 〈 女 青年 ， 普 通话 ) 

SPEED 设置 朗读 的 语 速 ， 取 值 为 0 一 100 

PITCH 设置 朗读 的 音调 ， 取 值 为 0 一 100 

VOLUME 设置 朗读 的 音量 ， 取 值 为 0 一 100 


STREAM_TYPE 
KEY_REQUEST_FOCUS 
AUDIO_FORMAT 
TTS_AUDIO PATH 


设置 音频 流 类 型 。 默 认 是 3， 表 示 音 乐 
设置 是 否 在 播放 合成 音频 时 打 断 音乐 播放 ， 默 认为 tue 
设置 音频 的 保存 格式 
设置 音频 的 保存 路 径 
estartSpeaking: 开始 语音 朗读 。 参 数 为 SynthesizerListener 对 象 ， 该 对 象 需 重 写 以 下 方法 。 
> onSpeakBegin: 朗读 开始 。 
> onSpeakPaused: 朗读 暂停 。 
> onSpeakResumed: 朗读 恢复 。 
> onBufferProgress: 合成 进度 变化 。 
> 
> 











onSpeakProgress: 朗读 进度 变化 。 
onCompleted: 朗读 完成 。 
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> onEvent: 事件 处 理 ， 一 般 是 业务 出 错 等 异常 。 


e synthesizeToUri: 只 保存 音频 不 进行 播放 ， 调 用 该 接口 就 不 能 调用 startSpeaking。 第 一 个 
参数 是 要 合成 的 文本 ， 第 二 个 参数 是 要 保存 的 音频 全 路 径 ， 第 三 个 参数 是 
SynthesizerListener 回调 接口 。 

pauseSpeaking: 暂停 朗读 。 

resumeSpeaking: 恢复 朗读 。 

stopSpeaking: 停止 朗读 。 

destroy: 回收 语音 合成 对 象 。 


在 线 合 成 发 音 人 选项 
讯 飞 语音 合成 示例 。 设置 


| 请 选择 发 诗 人 小 项 一 女 青 、 中 英 、 普 通 活 


小 天 一 女 再、 中 英 、 苦 通话 


小 字 一 男 青 、 中 英 、 曾 通话 


岂可 琳 一 女 表 、 英 汪 


部 利 一 男 青 、 英语 


玛 果 一 女 青 、 英 语 


小 研一 女 青 、 中 英 、 首 通话 


小 现 一 女 再 、 中 英 、 曾 通话 


小 峰 一 男 青 、 中 英 、 营 通话 


小 梅 一 女 青 、 中 英 、 粤 酒 








开始 合成 取消 合成 
小 莉 一 女 表 、 中 英 、 台 湾 普 通话 
暂停 播放 多 续 播 放 
15-51 选择 发 音 人 的 弹 窗 页 面 图 15-52 正在 播放 合成 的 语音 


语音 合成 的 演示 效果 如 图 15-51 和 图 15-52 所 示 。 其中, 图 15-51 为 选择 发 音 人 的 对 话 框 ， 
可 以 看 到 讯 飞 语音 提供 了 中 文 、 英 文 以 及 汉语 的 常见 方言 还 是 很 丰富 动听 的 ; 接着 点 击 “ 
台 合 成 ”按钮 ,语音 SDK 对 测试 诗歌 的 文本 进行 语音 合成 , 并 播放 合成 后 的 音频 流 , 如 图 15-52 
所 示 。 














15.5 ”实战 项 目 : 仿 滴 滴 打 车 


这 几 年 分 享 经济 如 火 如 茶 ， 从 阿姨 外 卖 到 滴 滴 打 车 ， 都 离 不 开 新 技术 、 新 思想 的 实践 。 
特别 是 打车 App， 大 家 或 多 或 少 都 用 过 ， 看 起 来 很 方便 ， 可 是 背后 的 技术 支持 着 实 不 简单 。 读 
者 是 否 想 过 自己 实现 一 个 类 似 的 打车 App 呢 ? 现在 就 让 我 们 一 步 一 个 脚印 ， 开 始 着 手 吧 ! 就 
算 没 法 做 出 真正 可 用 的 打车 App， 也 要 鼓 的 一 个 演示 用 的 “ 哄 哄 打车 ”。 





15.5.1 设计 思 


滴 滴 打 车 的 用 户 界面 主要 是 一 幅 地 图 配 上 相关 的 打车 信息 ， 打 车 的 具体 流程 不 外 乎 是 : 
用 户 开始 打车 一 司机 接 单一 司机 开 到 出 发 地 , 用 户 上 车 一 司机 开 到 目的 地 , 用 户 下 车 一 用 户 付 


第 15 章 第 三 方 开发 包 | 735 





款 行程 结束 。 这 里 为 了 突出 本 章 的 知识 点 ， 依 然 是 化 繁 为 简 ， 把 不 怎么 相关 的 控件 元 素 去 掉 ， 
形成 山寨 后 的 效果 , 如 图 15-53 和 图 15-54 所 示 。 其 中 , 图 15-53 所 示 为 打车 App 的 初始 页 面 ; 
图 15-54 所 示 为 行程 结束 后 的 评价 页 面 。 


thirdsdk 


行程 结束 ， 请 您 进行 评价 


食 食 食 


分 享 给 好 友 


QQ 好 友 QQ 空间 。。 路 讯 微 博 





提交 评价 





图 15-53 打车 App 的 初始 页 面 15-54 ”行程 结束 后 的 评价 页 面 


惯例 还 是 “大 家 来 找茬 ”， 看 看 这 个 “ 噶 叶 打 车 ”用 到 了 本 章 的 哪些 知识 点 ， 想 必 读者 
时 已 轻车熟路 全 部 找 出 来 了 。 


(1) 地 图 SDK: 主 界面 上 都 是 地 图 , 还 得 通过 地 图 显示 用 户 当 前 位 置 和 快车 的 行车 路 线 。 

(2) 语音 SDK: 每 当 遇 到 一 个 需要 提醒 司机 、 用 户 的 事件 或 路 况 信息 ， 比 如 “快车 已 经 
到 达 ”、“ 前 方 五 十 米 右 转 ”等 ， 都 会 响起 一 阵 悦耳 的 女声 播报 。 

(3) 支付 SDK: 行程 结束 ， 用 户 通 过 支付 宝 或 微 信 支付 ， 把 打车 费 付 款 给 打车 平台 ， 
打车 平台 向 司机 分 成 。 

(4) 分 享 SDK: 体验 到 快车 的 方便 快捷 ， 小 伙伴 们 想 不 想 分 享 给 好 友 呢 ? 分 享 成 功 有 红 
包 哦 。 


真实 的 打车 App 还 会 用 到 更 多 第 三 方 开发 包 ， 比 如 消息 推送 SDK、 统 计 分 析 SDK 等 。 不 
过 ， 实 战 项 目的 “ 哮 噶 打车” 仅 用 于 学 习 演示 ， 能 熟练 运用 上 面 4 个 SDK 已 经 足够 了 。 


15.5.2 ”小 知识 : 评分 条 RatingBar 


在 服务 行业 中 ， 商 家 信誉 是 一 个 很 重要 的 指标 ， 信 誉 好 的 商户 ， 生 意 自然 越 来 越 好 。 如 
何 评价 一 个 商户 的 信誉 等 级 呢 ? 这 依赖 于 消费 者 每 次 光顾 后 的 星 级 评价 。 无 论 是 在 淘宝 购物 ， 
还 是 使 用 滴 滴 打 车 ， 订 单 结束 了 都 会 提示 用 户 进行 评价 ， 此 时 用 到 的 评价 控件 为 评分 条 
RatingBar。 

RatingBar 其 实 是 拖 动 条 SeekBar 的 升级 版 ， 不 同 之 处 在 于 把 进度 标记 换 成 了 五 角 星 。 
RatingBar 除了 拥有 SeekBar 的 所 有 方法 ， 还 新 增 了 5 个 与 评分 相关 的 方法 ， 新 增 的 方法 与 属 
性 说 明 见 表 15-8。 
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表 15-8 RatingBar 的 新 增 方法 与 属性 说 明 

















lel) RatingBar 的 新 增 方法 说 明 
增 属性 
isIndicator “| setIsIndicator 是 否 作为 指示 器 。 如 果 是 指示 器 ， 就 不 可 通过 触摸 修改 评级 
numStars setNumStars 设置 星星 的 个 数 
rating setRating 设置 初始 评价 等 级 
stepSize setStepSize 设置 每 次 增 减 的 大 小 。 默 认为 总 数 的 十 分 之 一 ， 比 如 星星 总 
数 为 5， 默认 值 为 0.5 
无 setOnRatingBarChangeListener | 设置 评分 监听 器 。 


需 实现 接口 OnRatingBarChangeListener 的 onRatingChanged 
方法 


另外 ，RatingBar 提供 了 3 种 星星 样式 ， 用 于 不 同业 务 场景 时 的 评级 展示 。 评 分 条 的 样式 
说 明 见 表 15-9。 








表 15-9 评分 条 的 样式 说 明 


评分 条 style 属性 的 风格 星星 的 规格 大 小 默认 能 否 触摸 改变 评级 
?android:attr/ratingBarStyle 大 ， 默 认 值 能 


?android:attr/ratingBarStyleIndicator 不 能 








不 能 


尽管 RatingBar 提供 了 3 种 星星 样式 ， 却 是 换 汤 不 换 药 ， 评 分 条 的 星星 外 观 仍然 不 尽 如 人 
意 。 如 果 想 定制 星星 的 颜色 与 大 小 ， 就 得 自 定义 一 个 层次 图 形 描述 文件 ， 然 后 把 RatingBar 的 
progressDrawable 属性 设置 为 该 层次 图 形 。 下 面 是 自 定义 层次 图 形 XML 文件 定义 代码 : 
<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
<!-- background 定义 了 背景 图 片 ， 即 灰色 星星 -> 
<item 
android:id="(@+android:id/background" 
android:drawable="(@drawable/star_background"> 


?android:attr/ratingBarStyleSmall 


</item> 
<!-- secondaryProgress 定义 了 次 要 进度 图 片 ， 即 灰色 星星 --> 
<item 


android:id="(@+android:id/secondaryProgress" 
android:drawable="(@drawable/star_background"> 


</item> 
<!-- background 定义 了 主要 进度 图 片 ， 即 高 亮 星星 --> 
<item 


android:id="(@+android:id/progress" 
android:drawable="(@drawable/star_foreground"> 
</item> 
</layer-list> 
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下 面 是 使 用 RatingBar 的 代码 : 
public class RatingBarActivity extends AppCompatActivity implements 
OnCheckedChangeListener, OnRatingBarChangeL istener { 
private CheckBox ck_whole; 
private RatingBar rb_score; / 声明 一 个 评分 条 对 象 
Private TextView tv_rating; 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_rating_bar); 
ck_whole = findViewById(R.id.ck_whole); 
tv_rating = findViewById(R.id.tv_rating); 
ck_whole.setOnCheckedChangeListener(this); 
initRatingBar0D); / 初始 化 评分 条 

b 


/ 初始 化 评分 条 
private void initRatingBar0 { 
/ 从 布局 文件 中 获取 名 叫 rb_score 的 评分 条 
rb_score = findViewById(R.id.rb_score); 
/ 设置 不 作为 指示 器 ， 也 就 是 允许 拖 动 星星 
rb_score.setlIsIndicator(false); 
/ 设置 星星 的 个 数 
rb_score.setNumStars(5); 
/ 设置 初始 评价 等 级 
rb_score.setRating(3); 
1/ 设置 每 次 增 减 的 大 小 
rb_score.setStepSize(1); 
/ 设置 评分 监听 器 
rb_score.setOnRatingBarChangeListener(this); 
} 


public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
/ 依据 复 选 框 的 选中 状态 ， 设 置 评分 条 能 否 选择 半 颗 星星 
rb_score.setStepSize(ck_whole.isChecked() ? 1 : rb_score.getNumStars() / 10.0f); 
出 


/ 在 评分 发 生变 化 时 触发 

public void onRatingChanged(RatingBar ratingBar, float rating, boolean fromUser) { 
String desc = String.format(" 当 前 选中 的 是 %s 颗 星 ", CacheUtil.formatDecimal(rating, 1)); 
tv_rating.setText(desc); 
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评分 条 的 演示 效果 如 图 15-55 和 图 15-56 所 示 。 图 15-55 为 选择 两 颗 星 时 的 效果 图 .图 15-56 
为 选择 3 颗 半 星 时 的 效果 图 。 


Thirdsdk Thirdsdk 











只 可 选择 整 颗 星 只 可 选择 整 颗 星 





食 食 食 食 食 1 


当前 选中 的 是 2.0 颗 星 当前 选中 的 是 3.5 颗 星 





图 15-55 选择 两 颗 星 时 的 效果 图 图 15-56 选择 3 颗 半 星 时 的 效果 图 
15.5.3 ”代码 示例 


编码 与 测试 方面 需要 注意 以 下 4 点 : 
(1) 在 libs 目录 与 sre/main/jniLibs 目录 下 正确 放置 相关 的 SDK 文件 。 
(2) AndroidManifestxml 注 意 声明 相关 权限 ,并 注册 地 图 APPKEY 和 相应 的 activity 和 service。 
(3) 注意 地 图 服务 与 语音 服务 的 初始 化 操作 。 
(4) 使 用 真 机 测试 体验 效果 更 佳 。 


示例 代码 参见 本 书 附带 源码 thirdsdk 模块 的 TakeTaxActivityjava 和 TaxResultActivity,java， 
其 中 TakeTaxActivity.java 是 打车 过 程 页 面 ， 主 要 实现 呼叫 快车 、 行 车 路 径 追 踪 、 支 付 车 费 等 
功能 。TaxResultActivity.java 为 打车 结果 页 面 ， 主 要 实现 服务 评价 、 行 程 分 享 等 功能 。 

其 余 编码 没什么 难点 了 ， 赶 紧 把 “ 哄 哄 打车 ”安装 到 手机 上 ， 试 着 完整 运行 一 遍 ， 看 看 
是 什么 感觉 。 或 者 先 看 笔者 这 里 的 测试 效果 图 ， 一 点 都 不 难 ， 你 也 可 以 的 。 一 开始 打开 测试 
App, 填写 出 发 地 与 目的 地 ， 然 后 点 击 “ 开 始 叫 车 ”按钮 ，App 发 布 打车 请 求 ， 并 语音 播报 “等 
待 司 机 接 单 ”， 如 图 15-57 所 示 。 司 机 接 单 后 ，App 语音 播报 “司机 马上 过 来 ”， 因 为 截图 体 
现 不 了 声音 ， 所 以 页 面 下 方 另 外 加 了 一 排 文 字 显示 语音 播报 的 内 容 ， 如 图 15-58 所 示 。 

快车 到 达 用 户 位 置 后 ， 小 车 图 标 与 用 户 圆 点 重合 ， 同 时 App 语音 播报 “快车 已 经 到 达 ， 
请 上 车 ”， 如 图 15-59 所 示 。 然 后 用 户 上 车 ， 司 机 一 路 开 向 目的 地 ，App 语音 播报 “已 经 到 达 
目的 地 ， 欢 迎 下 次 再 来 乘 车 ”， 同 时 下 方 按钮 的 文字 变 为 “支付 车 费 ”， 如 图 15-60 所 示 。 

用 户 点 击 “ 支 付 车 费 ” 按钮， 页 面 下 方 弹出 付款 对 话 框 ， 如 图 15-61 所 示 。 确 认 付款 信息 
正确 无 误 后 ， 点 击 “ 确 认 付款 ”按钮 完成 支付 操作 ， 然 后 跳 到 评价 页 面 ， 用 户 可 在 此 给 快车 服 
务 打分 ， 也 可 将 打车 信息 分 享 给 好 友 ， 如 图 15-62 所 示 。 
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图 15-58 司机 马上 过 来 的 界面 ”图 15-59 快车 过 来 接客 时 的 界面 
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在 该 项 目的 App 编码 中 采用 了 本 


图 15-62 评价 完成 时 的 页 面 


15.6 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 常见 第 三 方 开发 包 ， 包 括 地 图 SDK〈 查 看 签名 信息 、 百 


度 地 图 、 高 德 地 图 ) 、 分 享 SDK QQ 分 享 、 微 信 分 享 ) 、 支 付 SDK (支付 宝 、 微 信 支 付 ) 、 
语音 SDK (文字 转 语 音 、 语 音 识别 、 语 音 合成 ) 。 最 后 设计 了 


-个 实战 项 目 “ 仿 滴 滴 打 车 ”， 


章 讲述 的 4 种 开发 包 的 代表 技术 。 另 外 ， 介 绍 了 如 何 使 用 评 
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分 条 。 
通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 
(1) 学 会 使 用 地 图 SDK 进行 定位 、 搜 索 、 测 量 等 操作 。 
(2) 学 会 使 用 分 享 SDK 把 消息 内 容 分 享 到 QQ 与 微 信 。 
(3) 初步 了 解 支付 的 交易 流程 ， 并 学 会 使 用 支付 SDK 演示 支付 缴费 功能 。 
(4) 学 会 使 用 语音 SDK 完成 语音 的 识别 和 语音 的 合成 。 


本 章 介绍 App 开发 常见 的 性 能 优化 技术 ， 主 要 包括 通过 优化 布局 文件 实现 页 面 风格 的 统 
“\ 通 过 检测 手段 和 预防 措施 处 理 内 存 泄漏 的 问题 `. 运 用 线程 池 技术 对 线程 资源 进行 有 效 管理 、 
通过 监测 当前 电量 与 屏幕 事件 开启 省 电 模式 , 最 后 结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 图 
片 缓存 框架 ”的 设计 与 实现 。 


16.1 布局 文件 优化 


Android 的 页 面 布局 千变万化 ,但 对 某 个 具体 的 App 来 说 ,往往 要 求 有 统一 的 风格 ， 比 如 
统一 的 导航 栏 、 统 一 的 竖 屏 布局 与 横 屏 布局 、 统 一 的 窗口 主题 等 , 这 种 统一 风格 就 像 学 生 的 校 
服 和 白领 的 制服 。 本 节 介 绍 风格 统一 的 几 种 方式 , 包括 增加 公共 布局 减少 重复 布局 、 使 用 占 位 
视图 自 适应 调整 屏幕 布局 、 自 定义 窗口 主题 等 内 容 。 


16.1.1 减少 重复 布局 


第 7 章 介绍 工具 栏 Toolbar 的 时 候 提 到 在 布局 文件 中 加 入 该 节点 实现 顶部 导航 栏 效果 。 由 
于 App 内 部 存在 多 个 活动 页 面 ， 为 了 确保 所 有 页 面 的 风格 统一 ， 因 此 必须 给 每 个 页 面 的 布局 
文件 添加 Toolbar。 如 此 一 来 ,这些 XML 文件 几乎 包含 一 模 一 样 的 Toolbar 布局 ， 不 但 造成 重 
复 布局 ,而 且 不 易 扩 展 ， 因 为 每 往 导 航 栏 上 增加 一 个 新 控件 ， 都 得 把 涉及 的 XML 文件 统统 修 
改过 去 。 

这 种 重复 的 导航 栏 布局 ， 若 能 参照 代码 中 的 公共 函数 抽出 来 形成 单独 的 公共 布局 文件 ， 
由 各 个 页 面 布局 文件 分 别 引 用 ， 沁 不 妙 哉 ?Android 确实 提供 了 对 应 的 途径 ， 只 要 在 页 面 布局 
中 使 用 include 标签 声明 公共 布局 ， 即 可 实现 在 该 页 面 中 导入 公共 布局 内 容 ， 功 能 类 似 于 Java 
的 import 或 C/C++ 的 include 关键 字 。include 标签 适用 于 在 多 个 布局 文件 中 导入 相同 的 XML 








742 | Android Studio 开发 实战 : 从 零 基 础 到 App 上 线 (第 2 版 ) 


布局 片段 ， 比 如 相同 的 标题 栏 、 相 同 的 广告 栏 、 相 同 的 进度 栏 等 。include 标签 的 用 法 很 简单 ， 
只 需 一 行 配置 即 可 完成 公共 布局 引用 ， 如 下 面 的 代码 表示 引用 了 一 个 名 为 common_title.xml 
的 公共 布局 文件 : 

<!-- 在 此 插入 common title xml 所 定义 的 布局 -二 

<include layout="(@layout/common title" /> 


公共 布局 文件 的 根 节点 可 以 是 LinearLayout、RelativeLayout 等 布局 节点 ， 不 过 外 部 的 页 
面 布局 文件 往往 已 经 有 了 相同 的 布局 节点 , 这 时 子 布局 的 根 节点 就 变 成 元 余 的 了 , 但 是 布局 文 
件 必须 有 根 布局 节点 ， 不 能 把 控件 作为 根 节点 。 为 了 解决 根 布局 元 余 的 问题 ，Android 提供 了 
merge 标签 进行 布局 优化 ， 即 把 merge 标签 作为 公共 布局 文件 的 根 节点 。merge 标签 代替 了 
LinearLayout、RelativeLayout 等 原 根 节点 的 位 置 ， 也 就 是 告诉 编译 器 : 我 只 是 一 个 占 位 的 合并 
标签 , 不 需要 对 我 做 布局 处 理 。 这样 ，App 在 泻 染 界面 时 只 是 原样 导入 merge 标签 下 的 视图 内 
容 ， 不 做 根 布局 尺寸 的 计算 和 调整 ， 从 而 提高 了 UI 的 加 载 效率 。 

为 了 更 好 地 理解 include 与 merge 标签 的 用 法 ， 接 下 来 举 一 个 公共 布局 文件 的 示例 : 

<merge xmlns:android="http://schemas.android.com/apk/res/android" 

xmlns:app="http://schemas.android.com/apk/res-auto" > 





<!-- 下 面 定义 了 公共 的 标题 栏 布局 -> 

<android.support.v7.widget.Toolbar 
android:id="(@+id/tl_head" 
android:layout_width="match_parent" 
android:layout_height="50dp" 
android:background="(@color/blue_light" 
app:navigationIcon="(@drawable/ic_back" > 


<RelativeLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" > 


<TextView 
android:id="(@+id/tv_title" 
android:layout_width="wrap_content" 
android:layout_height="match_parent" 
android:layout_centerInParent="true" 
android:paddingRight="50dp" 
android:gravity="center" 
android:textColor="@colorblack" 
android:textSize="20sp" 亡 


<ImageView 
android:id="(@-+id/iv_share" 
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android:layout width="wrap_content" 
android:layout_height= "match parent" 
android:layout_ alignParentRight="true" 
android:src="@drawable/ic_share" 
android:scaleType="fitCenter" /> 
</RelativeLayout> 
</android.support.v7.widget.Toolbar> 
</merge> 


处 理 公共 布局 必然 要 有 对 应 的 公共 页 面 代码 , 为 此 我 们 声明 一 个 名 为 BaseActivity 的 活动 
基 类 ， 该 基 类 默认 处 理 公共 布局 中 的 控件 操作 ， 具 体 的 活动 页 面 由 BaseActivity 派生 而 来 。 活 
动 基 类 的 示例 代码 如 下 : 

public class BaseActivity extends AppCompatActivity implements OnClickListener { 


@Override 
protected void onResume() { 
super.onResume(); 
1/ 从 布局 文件 中 获取 名 叫 tl_head 的 工具 栏 
Toolbar tL_ head = findViewById(R.id.tL_ head); 
/ 使 用 tl_ head 替换 系统 自 带 的 ActionBar 
setSupportActionBar(tl head); 
/ 给 tLhead 设置 导航 图 标的 点 击 监听 器 
// setNavigationOnClickListener 必须 放 到 setSupportActionBar 之 后 ， 不 然 不 起 作用 
tl_ head.setNavigationOnClickListener(new OnClickListenerO { 


(QOverride 
public void onClick(View view) { 
finish(); 
四 
D; 
findViewById(R.id.iv_share).setOnClickListener(this); 
1 
/ 设置 页 面 标题 


protected void setTitle(String title) { 
TextView tv_title = findViewById(R.id.tv_title); 
tv_title.setText(title); 


public void onClick(View v) { 
if (v.getId) 一 R.id.iv_share) { 
Toast.makeText(this, "请 先 实现 分 享 功能 噢 ", Toast.LENGTH_LONG).show0; 
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} 
最 后 给 出 两 个 实际 页 面 的 布局 ， 分 别 使 用 include 标签 导入 公共 布局 common_title， 然 后 
在 代码 中 分 别 从 BaseActivity 派生 两 个 具体 的 页 面 类 。 其 中 一 个 页 面 的 代码 举例 如 下 : 


public class IncludeOneActivity extends BaseActivity { 


(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_include_one); 
setTitle(" 时 事 频 道 "); 


} 
运行 后 的 公共 导航 栏 效果 如 图 16-1 和 图 16-2 所 示 。 其 中 ， 图 16-1 为 第 一 个 时 事 频道 的 
界面 ， 图 16-2 为 第 二 个 体育 频道 的 界面 。 


体育 频道 吧 


这 是 采用 了 公共 导航 的 第 二 个 页 面 





这 是 采用 了 公共 导航 的 第 一 个 页 面 





图 16-1 时 事 频道 页 面 图 16-2 体育 频道 页 面 
16.1.2 ” 自 适应 调整 布局 


在 页 面 上 根据 条 件 展示 不 同 的 视图 常常 需要 设置 视图 的 可 视 属性 。 比 如 调用 setVisibility 
方法 设置 可 视 属 性 ， 若 需 展示 则 将 可 视 属性 设置 为 View.VISIBLE， 若 需 隐藏 则 将 可 视 属性 设 
置 为 View.GONE。 然 而 gone 的 视图 只 是 看 不 到 罢了 ,在 界面 泻 染 时 还 是 会 被 加 载 。 要 想 事先 
不 加 载 视图 ， 在 条 件 匹 配 时 才 加 载 ， 就 可 以 使 用 标签 ViewStub。 

占 位 视图 ViewStub 类 似 一 个 简单 的 View， 但 其 内 部 布局 由 属性 layout 指定 。 在 App 加 
载 页 面 时 ，ViewStub 并 不 显示 布局 内 容 ， 只 有 在 代码 中 调用 ViewStub 对 象 的 inflate 方法 时 ， 
layout 指定 的 布局 才 会 展示 出 来 。 基于 以 上 处 理 逻 辑 , ViewStub 在 提高 布局 性 能 上 有 以 下 两 个 
特点 : 

(1) ViewStub 在 加 载 时 只 占用 大 约 一 个 View 的 内 存 ， 不 占用 layout 整个 布局 需要 的 内 存 。 
(2) ViewStub 一 旦 调用 inflate 方法 ,就 立即 显示 所 包含 的 页 面 内 容 。 如 果 还 想 再 次 隐藏 
或 显示 布局 ， 就 要 通过 setVisibility 方法 实现 。 
举 一 个 ViewStub 实际 运用 的 例子 ， 手 机 在 竖 屏 和 横 屏 之 间 切 换 时 ， 有 时 希望 显示 不 同 的 
布局 ， 比 如 竖 屏 显示 列表 、 横 屏 显 示 网 格 。 如 此 一 来 ,在 页 面 布局 中 预 留 两 个 ViewStub 节点 ， 
-个 给 ListView 占 位 ， 另 一 个 给 GridView 占 位 ， 有 具体 的 布局 内 容 如 下 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_ width="match _ parent" 
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android:layout_height="match_parent" 
android:orientation="vertical" > 


<!-- 在 此 插入 common titlexml 所 定义 的 布局 -> 
<include layout="(@layout/common title" /> 


<!-- 下 面 的 占 位 视图 包含 的 是 列表 布局 viewstub_list.xml -> 
<ViewStub 
android:id="(@+id/vs_list" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout="(@layout/viewstub_list" /> 


<!-- 下 面 的 占 位 视图 包含 的 是 网 格 布局 viewstub_grid.xml -> 
<ViewStub 
android:id="(@+id/vs_grid" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout="(@layout/viewstub_grid" /> 
</LinearLayout> 


相对 应 的 ， 页 面 代码 增加 对 横竖 屏 的 方向 判断 ， 如 果 当 前 为 竖 屏 ， 就 令 占 位 视图 显示 列 
表 布 局 ， 如 果 当 前 为 横 屏 ， 就 令 占 位 视图 显示 网 格 布 局 。 页 面 代码 举例 如 下 ; 


public class ScreenSuitableActivity extends BaseActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_screen_suitable); 
setTitle(" 自 适应 布局 演示 页 面 "); 
/ 获取 当前 的 屏幕 配置 
Configuration config = getResources().getConfiguration(); 
if (config.orientation == Configuration.ORIENTATION_PORTRAIT) { / 竖 屏 
showList0; / 显示 列表 
} else { // 横 屏 
showGrid0; / 显示 网 格 


有 


/ 以 列表 形式 呈现 六 大 行星 

private void showList() { 
/ 从 布局 文件 中 获取 名 叫 vs_list 的 占 位 视图 
ViewStub vs_list = fndViewById(R.id.vs_list; 
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} 


上 述 自 适应 布局 的 演示 效果 如 图 16-3 和 图 16-4 所 示 。 其 中 ， 
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vs_listinflate(); 人 展开 占 位 视图 

// 下 面 通过 列表 视图 展示 行星 信息 

ListView lv_hello = findViewById(R.id.lv_hello); 

PlanetAdapter adapter = new PlanetA dapter(this, R.layout.item list, 
Planet.getDefaultList(), Color WHITE); 

lv_hello.setAdapter(adapter); 


// 以 网 格 形式 呈现 六 大 行星 
Private void showGridO { 
/ 从 布局 文件 中 获取 名 叫 vs_grid 的 占 位 视图 
ViewStub vs_grid = findViewById(R.id.vs_grid); 
vs_grid.inflate(0; / 展开 占 位 视图 
/ 下 面 通过 网 格 视图 展示 行星 信息 
GridView gv_hello = findViewByld(R.id.gv_hello); 
PlanetAdapter adapter = new PlanetAdapter(this, R.layout.item grid, 
PlanetgetDefaultList0, Color WHITE); 
gv_hello.setAdapter(adapter); 


界面 ， 图 16-4 为 展示 网 格 的 横 屏 界面 。 


使 





自 适 应 布局 演示 页 面 


水 星 

水 星 是 太阳 系 八大 行星 最 办 侧 也 是 最 小 的 一 颗 行 星 ,也 
是 内 太阳 最 近 的 行星 

金星 

金 攻 是 太阳 系 八大 行星 之 一 ， 排行 第 二 ,距离 太 

阳 0725 天 文 单位 水 星 站 


Pe 


地 球 
地 球 是 太阳 系 八 大 行星 之 一 ， 排 行 第 三 ,也 是 太阳 系 叫 S 
页 径 、 风 昌 和 宙 太 了 大 的 内 地 行星 ， 距离 太阳 1.5 亿 公 


类 至 是 是 本 了 和 作答 有 小 各 全曲/ 关 生 之 0 和 地 4 人 之 


第 
y 4 2 行 : = 行星 ， 也 是 高 太阳 最 近 的 行星 二 , 距 高 太阳 0.725 天 文 单位 是 太阳 系 中 直径 。 质量 和 密度 好 大 
火星 是 太阳 系 八大 行星 之 一 ， 排行 第 四 ， 属于 类 地 行 i 


星 , 直径 约 为 地 球 的 53% 


未 星 火星 木星 土星 
木星 是 太阳 系 八 大 行星 中 体积 最 大 、 自 转 最 快 的 行 

星 排行 第 五 ， 它 的 质量 为 太阳 的 千 分 之 一 ， 伍 为 太阳 多 
系 中 其 它 七 大 行星 质量 总 和 的 2.5 信 4 
土星 


图 16-3 为 展示 列表 的 竖 屏 





排行 




















者 为 大和 八大 生 星 之 一 ， 拓 行 第 六 ,体积 仅 次 于 内 本 内 人 全 全 宫 记 近 和 so 友和 时 从 让 和 扫 信 向 大 天 认 信 全 帮 = 于 
的 千 分 之 一 ， 但 为 太阳 系 中 其 它 七 大 行星 
图 16-3 占 位 视图 展示 竖 屏 列表 图 16-4 占 位 视图 展示 横 屏 网 格 
16.1.3” 自 定义 窗口 主题 
肯 Android Studio 创建 一 个 新 模块 ， 默 认 的 App 主题 为 系统 自 带 的 
Theme.AppCompat.Light.DarkActionBar， 即 浅 灰 背景 加 深 色 导航 栏 。 如 果 大 家 都 用 默认 主题 ， 


App 势必 变 得 千篇一律 、 毫 无 特色 。 要 想 让 自己 的 App 吸引 眼球 ， 首 先 得 打造 非 同 一 般 的 主 
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题 ， 比 如 粉红 的 小 女人 风格 、 草 绿 的 小 清新 风格 、 天 蓝 的 闷 驭 男 风格 等 。 

自 定 义 主题 的 配置 可 在 res/values/styles.xml 中 定义 ， 配 置 方式 同一 般 视图 的 style 风格 配 
置 , 不 同 的 是 如 何 应 用 自 定义 主题 。 一 般 视图 可 在 布局 文件 的 节点 中 使 用 style 属性 设置 风格 ， 
对 于 视窗 则 可 通过 以 下 途径 设置 主题 : 


(1) 修改 AndroidManifest.xml， 往 application 节点 增加 android:theme 属性 ， 表 示 对 该 
App 的 所 有 页 面 设置 指定 的 主题 ; 或 者 往 activity 节点 增加 android:theme 属性 ,表示 对 指定 的 
活动 页 面 单独 设置 主题 。 

(2) 打开 Activity 代码 ， 在 setContentView 方法 之 前 调用 方法 setTheme(R.style.***) 完 成 
该 页 面 的 主题 设置 。 

(3) 如 果 是 自 定 义 对 话 框 ， 就 在 Dialog 的 构造 函数 中 传 入 指定 主题 的 资源 编号 。 


下 面 介绍 窗口 主题 经 常 需要 自 定义 的 属性 。 


android:gravity: 窗口 内 部 的 对 齐 方式 。 
android:background: 窗口 内 部 的 背景 。 
android:windowBackground: 整个 窗口 的 背景 ， 包 括 边 框 与 内 部 。 
android:windowFrame: 窗口 框架 图 像 。 注意 该 属性 并 不 只 是 边框 区 域 ， 还 包括 内 部 窗 
口 ,， 所 以 如 果 windowFrame 设置 为 不 透明 的 图 像 ， 那么 内 部 窗口 将 只 显示 这 幅 不 透明 
的 图 像 。 
android:windowNoTitle: 窗口 是 否 不 要 默认 的 标题 栏 ， 即 是 否 展示 ActionBar。 
android:windowFullscreen: 窗口 是 否 全 屏 。 
android:windowIsTranslucent: 窗口 是 否 半 透明 。 
android:windowIsFloating: 窗口 是 否 基 浮 。 
android:windowAnimationStyle: 窗口 切换 动画 的 样式 。 
android:windowEnterAnimation: 进入 窗口 的 动画 。 
android:windowExitAnimation: 退出 窗口 的 动画 。 

在 以 上 属性 中 , 与 背景 设置 有 关 的 3 个 属性 容易 混淆 ， 
分 别 是 android:windowFrame、android:windowBackground 
和 android:background。 下 面 测试 一 下 这 3 个 属性 对 应 的 视 
窗 界 面 ， 看 看 究竟 是 什么 模样 。 

首先 设 定 页 面 背景 为 绿色 ， 接 着 将 窗口 背景 属性 
android:windowBackground 设置 为 半 透 明 红色 ， 效 果 如 图 
16-5 所 示 。 此 时 对 话 框 外 围 变 为 深 黄 绿色 ， 即 窗口 对 外 半 图 155 windowBackground 设置 为 
透明 ， 使 得 页 面 背景 与 窗口 背景 混合 在 一 起 。 站 党 辕 寻 忆 的 名 当 

然后 将 android:background 设置 为 半 透 明 红色 , 效果 如 图 16-6 所 示 。 此 时 对 话 框 外 围 变 为 
红色 ， 四 周边 框 为 深 绿色 ， 表 示 窗 口内 部 对 外 不 透明 ， 但 窗口 边框 对 外 透明 。 

最 后 将 android:windowFrame 设置 为 半 透 明 红色 , 效果 如 图 16-7 所 示 。 此 时 对 话 框 内 部 蒙 
上 半 透 明 红色 ,四 周边 框 变 为 黄 绿 色 , 说 明 窗口 内 部 对 外 不 透明 但 对 内 半 透 明 , 窗口 边框 对 外 
半 透 明 。 
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图 16-6 _ background 设置 为 半 透 明 红 色 的 效果 图 16-7 windowFrame 设置 为 半 透 明 红 色 的 效果 
16.2 ”内 存 泄漏 处 理 


内 存 泄漏 指 的 是 程序 运行 时 未 能 正确 回收 部 分 内 存 ， 导 致 这 些 内 存 既 不 能 被 自身 使 用 ， 
又 不 能 被 其 他 程序 使 用 ， 从 而 变 成 垃圾 内 存 。 一 旦 内 存 泄漏 无 法 得 到 控制 ， 该 程序 占用 的 内 存 
就 会 越 来 越 大 ， 最 终 只 能 强行 结束 ， 和 否则 会 导致 系统 死机 。 本 节 首 先 介绍 Android 开发 如 何 检 
测 内 存 泄漏 ， 然 后 详细 阐述 各 种 场景 下 的 内 存 泄漏 预防 措施 。 


16.2.1 内 存 泄漏 的 检测 


C/C++ 存 在 指针 的 概念 ， 每 当 程 序 需要 处 理 数据 时 ， 便 从 内 存 中 开辟 一 块 区 域 ， 并 把 该 区 
域 的 首 地 址 赋值 给 一 个 指针 , 这 样 程序 才能 够 操作 该 指针 指向 的 内 存 。 因 为 C/C++ 设计 上 的 原 
因 ， 手 工分 配 的 内 存 也 要 手工 释放 ， 如 果 没 有 及 时 释放 内 存 就 会 产生 内 存 泄漏 。 

Java 设计 之 初 已 经 实现 了 多 数 情况 的 内 存 自 动 回收 , 不 过 在 Android 开发 中 , 内 存 回 收 机 
制 并 不 总 会 奏效 。 情 况 一 是 调用 了 非 Java 接口 ， 比 如 调用 了 JNI 接口 ，JNI 代码 中 由 C/C++ 
分 配 的 内 存 就 要 手工 回收 ;情况 二 是 调用 了 外 部 服务 ， 使 用 完毕 就 得 手工 通知 外 部 服务 回收 ; 
情况 三 是 异步 处 理 ， 实 时 的 内 存 回收 机 制 显然 等 不 了 耗 时 较 久 的 异步 处 理 任务 。 

要 对 内 存 泄漏 问题 进行 优化 , 首先 得 检测 App 是 否 发 生 内 存 泄漏 。 正常 情况 下 , 一 个 App 
占用 的 内 存 有 一 个 峰值 ， 达 到 这 个 峰值 后 ， 只 要 退出 App 页 面 ， 占 用 的 内 存 大 小 就 会 降下 来 。 
但 是 如 果 产 生 内 存 泄漏 ， 这 个 App 占用 的 内 存 大 小 是 没有 峰值 的 ， 随 着 页 面 的 重复 打开 或 时 
间 的 不 断 流逝 ， 该 App 消耗 的 内 存 越 变 越 大 ， 这 便 表示 出 现 了 内 存 泄漏 状况 。 因 此 ， 只 要 能 
够 监控 App 的 运行 内 存 变化 情况 ， 即 可 间接 判断 这 个 App 是 否 发 生 内 存 泄漏 。 

Android Studio 3.0 带 来 了 全 新 的 内 存 检测 工具 ， 使 用 Android Studio 运行 测试 应 用 ， 点 击 
底部 的 “Android Profiler” 标 签 ， 主 界面 下 方 就 弹出 分 析 器 窗口 ， 如 图 16-8 所 示 。 

分 析 窗 从 上 到 下 分 为 三 部 分 , 顶部 一 栏 有 两 个 下 拉 框 , 第 一 个 下 拉 框 可 选择 测试 机 型 (如 
图 示 的 DOOV V3) ， 第 二 个 下 拉 框 可 选择 调试 的 App 包 名 (例如 com.example.performance 
表示 performance 应 用 ) 。 窗 口中 部 是 待 分 析 的 资源 图 表 ， 依 次 包括 中 央 处 理 器 CPU、 内 存 
Memory、 网 络 Network。 窗 口 底部 则 为 时 间 轴 ， 可 观看 CPU、Memory、Network 随时 间 流 逝 
的 动态 使 用 情况 。 
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图 16-8 内存 检测 的 分 析 器 窗口 
接 下 来 通过 分 析 窗 观看 一 下 测试 应 用 的 内 存 消耗 情况 ， 从 图 16-9 可 见 ，performance 应 用 


当前 已 消耗 13.82MB (注意 左边 为 刻度 ， 右 边 才 是 真实 数值 》。 在 该 App 上 左 点 右 点 ， 打 开 
一 个 包含 多 张 图 片 的 页 面 ， 此 时 的 内 存 统计 图 表 如 图 16-10 所 示 。 
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图 16-9 测试 应 用 在 打开 图 片 页 面前 的 内 存 消耗 
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图 16-10 测试 应 用 反复 打开 图 片 页 面 后 的 内 存 消 耗 


从 图 16-10 可 见 ， 这 时 测试 应 用 performance 的 内 存 消耗 量 达到 了 28.52MB， 反 复 地 打开 
和 关闭 页 面 ， 如 果 发 现 App 占用 的 内 存 只 增 不 减 ， 那 么 毫 无 疑问 发 生 了 内 存 泄漏 。 


16.2.2 ”内 存 泄漏 的 发 生 
上 一 小 节 介绍 如 何 检测 发 生 了 内 存 汇 漏 ， 那 么 为 进一步 观察 内 存 泄露 现象 ， 下 面 给 出 两 
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个 例子 分 别 进行 说 明 。 
1. 未 能 移 除 定时 的 Runnable 任务 


前 面 各 章 有 需要 延 时 处 理 时 ， 常 常 调用 Handler 对 象 的 postDelayed 方法 ， 由 该 方法 延迟 
- 段 时 间 后 执行 设 定 好 的 Runnable 任务 。 若 要 实现 动画 效果 ， 则 循环 执行 若干 次 postDelayed 

方法 。 你 可 曾 想 过 ,这 里 蕴含 着 不 小 的 内 存 泄 漏 风 险 ， 如果 不 谨慎 对 待 ，App 很 可 能 多 跑 几 次 
就 挂 了 。 

比如 下 面 的 代码 每 隔 2 秒 打印 一 行 日 志 ， 并 在 onDestroy 页 面 退出 时 根据 开关 判断 是 否 移 
除 任务 ， 完 整 代码 如 下 : 

public class RemoveTaskActivity extends AppCompatActivity implements OnClickListener { 

private CheckBox ck_remove; 























private TextView tv_remove; 

private Button btn_remove; 

private String mDesc = ""; 

private boolean isRunning = false; // 定时 任务 是 否 正在 运行 
private Handler mHandler = new Handler0; / 声明 一 个 处 理 器 对 象 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_remove_task); 
ck_remove = findViewById(R.id.ck_remove); 
tv_remove = findViewById(R.id.tv_remove); 
btn_remove = findViewById(R.id.btn_remove); 
btn_remove.setOnClickListener(this); 
TextView tv_start = findViewById(R.id.tv_start); 
tv_startsetText(" 页 面 打开 时 间 为 : "+ DateUtil.getNowTime0 〇 ); 


public void onClick(View v) { 
if (v.getId() 一 Rid.btn_remove) { 
if (lisRunning) { 
btn_remove.setText(" 取 消 定时 任务 "); 
// 立即 启动 定时 任务 


mHandler.post(mTask); 

}else { 
btn_remove.setText(" 开 始 定 时 任务 "); 
// 移 除 定时 任务 
mHandler.removeCallbacks(mTask); 

上 

isRunning = !isRunning; 
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protected void onDestroy() { 
super.onDestroy(); 
if (ck_remove.isChecked()) { 
// 移 除 定时 任务 
mHandler.removeCallbacks(mTask); 


// 定义 一 个 定时 任务 ， 用 于 定时 发 送 广播 
private Runnable mTask = new Runnable() { 
(QOverride 
public void run0) { 
Intent intent = new Intent(TASK_EVENT); 
/ 通过 本 地 的 广播 管理 器 来 发 送 广播 


LocalBroadcastManager.getInstance(RemoveTaskActivity.this).sendBroadcast(intent); 


// 延迟 2 秒 后 再 次 启动 定时 任务 
mHandler.postDelayed(this, 2000); 


号 


public void onStart() { 

super.onStart(); 

/ 创建 一 个 定时 任务 的 广播 接收 器 

taskReceiver = new TaskReceiver(); 

/ 创建 一 个 意图 过 滤器 ， 只 处 理 指定 事件 来 源 的 广播 

IntentFilter filter = new IntentFilter(TASK_EVENT); 

/ 注册 广播 接收 器 ， 注 册 之 后 才能 正常 接收 广播 

LocalBroadcast Manager.getInstance(this).registerReceiver(taskReceiver, filter); 
’ 


public void onStop(O) { 
/ 注销 广播 接收 器 ， 注 销 之 后 就 不 再 接收 广播 
LocalBroadcastManager.getInstance(this).unregisterReceiver(taskReceiver); 
super.onStop(); 

} 


// 声明 一 个 定时 任务 广播 事件 的 标识 串 
private String TASK_ EVENT = "com.example.performance.task"; 
/ 声明 一 个 定时 任务 的 广播 接收 器 


private TaskReceiver taskReceiver; 


// 定义 一 个 广播 接收 器 ， 用 于 处 理 定时 任务 事件 
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Private class TaskReceiver extends BroadcastReceiver { 
/ 在 收 到 定时 任务 的 广播 时 触发 
public void onReceive(Context context Intent intent) { 
让 (intent !=nulD) { 
mDesc = String.format("%s%s 打印 了 一 行 测试 日 志 \n", mDesc, 
DateUtil.getNowTime()); 
tv_remove.setText(mDesc); 


Bp 


} 

首次 进入 该 测试 页 面 ， 点 击 “ 开 始 定 时 任务 ”按钮 后 ， 页 面 每 隔 2 秒 打印 一 行 日 志 ， 
图 16-11 所 示 。 然 后 不 停止 也 不 移 除 定时 任务 ， 直 接 退 出 该 页 面 ， 按 道理 原 测试 页 面 上 的 内 存 
都 应 该 回收 。 不 过 接着 重新 进入 测试 页 面 ， 还 没 点 击 “ 开 始 定时 任务 ”按钮 ， 页 面 已 经 在 元 自 
欢快 地 打印 日 志 了 ， 如 图 16-12 所 示 ， 很 明显 上 次 退出 页 面 时 系统 未 能 自动 回收 内 存 。 











performance performance 


口 退出 时 是 否 回收 任务 口 退出 时 是 否 回收 任务 
取消 定时 任务 开始 定时 任务 


页 面 打 开 时 间 为 : 16:54:38 页 面 打开 时 间 为 : 16:55:53 
16:54:58 打印 了 一 行 测试 日 志 16:55:54 打印 了 一 行 测试 日 志 
16:55:00 打印 了 一 行 测试 日 志 16:55:56 打印 了 一 行 测试 日 志 
16:55:02 打印 了 一 行 测试 日 志 16:55:58 打印 了 一 行 测试 日 志 





图 16-11 开始 定时 任务 的 测试 页 面 图 16-12 重新 进入 测试 页 面 的 情况 
2. 未 能 注销 系统 的 闹钟 提醒 服务 


定时 处 理 除 了 可 以 循环 调用 postDelayed 方法 外 ， 还 可 以 在 系统 的 闹钟 提醒 服务 中 注册 定 
时 事件 ， 并 接收 系统 的 闹钟 广播 进行 定时 处 理 。 使 用 系统 服务 也 需 小 心 ， 因为 系统 的 后 台 服 务 
不 知道 App 页 面 会 在 什么 时 候 关 闭 ， 若 放任 自流 ， 则 又 是 一 个 内 存 泄漏 的 引爆 点 。 

比如 下 面 的 代码 利用 闹钟 提醒 服务 每 阳 3 秒 打印 一 行 日 志 , 并 在 onDestroy 中 根据 开关 判 
断 是 否 注销 服务 ， 完 整 代码 如 下 : 


public class LogoutServiceActivity extends AppCompatActivity implements OnClickListener { 
private CheckBox ck_logout; 
private Button btn_alarm; 
private static TextView tv_alarm; 
private static PendingIntent pIntent; “// 声明 一 个 延迟 意图 对 象 
Private static AlarmManager mAlarmManager; / 声明 一 个 闹钟 管理 器 对 象 
Private static String mDesc; 
private static int mDelay = 3000; / 闹钟 延迟 的 间隔 
private boolean isRunning = false; // 六 钟 是 否 已 经 设置 





protected void onCreate(Bundle savedInstanceState) { 
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super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_logout_service); 

ck_logout = findViewById(R.id.ck_ logoub; 

tv_alarm = findViewById(R.id.tv_alarm); 

btn_alarm = findViewById(R.id.btn_alarm); 
btn_alarm.setOnClickListener(this); 

/ 创建 一 个 广播 事件 的 意图 

Intent intent = new Intent(ALARM EVENT); 

/ 创建 一 个 用 于 广播 的 延迟 意图 

pItent= PendingIntent.getBroadcast(this, 0, intent, PendingIntentFLAG_UPDATE_CURRENT); 
/ 从 系统 服务 中 获取 闹钟 管理 器 

mAlarmManager = (AlarmManager) getSystemService( ALARM SERVICE): 
mDesc =""; 

TextView tv_start = findViewById(R.id.tv_start); 

tv_startsetText(" 页 面 打开 时 间 为 : "+ DateUtil.getNowTime0 〇 ); 


protected void onDestroy() { 
super.onDestroy(); 
if (ck_logout.isCheckedO)) { 
// 取消 已 设 定 的 闹钟 提醒 


mAlarmManager.cancel(pIntent); 


} 


public void onClick(View v) { 
if (v.getId() 一 R.id.btn_alarm) { 

if (lisRunning) { 
/ 在 Android4.4 之后， 操作 系统 为 了 节能 省 电 ， 会 调整 alarm 唤醒 的 时 间 ， 
// 所 以 setRepeating 方法 不 保证 每 次 工作 都 在 指定 的 时 间 开 始 ， 
/ 此 时 需要 先 注销 原 闹 钟 ， 再 调用 set 方法 开启 新 六 钟 。 

mAlarmManager.setRepeating(AlarmManager.RTC_ WAKEUP., 
System.currentTimeMillis(), 3000, pIntent); 
/ 设 定 延 迟 若干 时 间 的 一 次 性 定时 器 
mAlarmManager.set(AlarmManagerRTC_ WAKEUP, 
System.currentTimeMillis()}+mDelay, pIntent); 

mDesc = DateUtil.getNowTime0 + ”设置 闹钟 "; 
tv_alarm.setText(mDesc); 
btn_alarm.setText(" 取 消 闹钟 "); 

}else{ 
/ 取消 已 设 定 的 六 钟 提醒 
mAlarmManager.cancel(pIntent); 
btn_alarm.setText(" 设 置 闹钟 "); 
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} 


isRunning = !lisRunning; 
! 


/ 声明 一 个 闹钟 广播 事件 的 标识 串 
private String ALARM_EVENT= "com.example.performance.alarm"; 


// 定义 一 个 闹钟 广 播 的 接收 器 
public static class AlarmReceiver extends BroadcastReceiver { 
// 一 旦 接收 到 闪 钟 时 间 到 达 的 广播 ， 马 上 触发 接收 器 的 onReceive 方法 
public void onReceive(Context context, Intent intent) { 
if (intent !=nulD) { 
让 (tv_alarm != nul) { 
mpDesc = String.format("%s\n%s 闵 钟 时 间 到 达 ", mDesc, DateUtil.getNowTime()); 
tv_alarm.setText(mDesc); 


repeatAlarm(); // 重复 闹钟 提醒 设置 


} 

} 

/ 重复 闹钟 提醒 设置 

private static void repeatAlarm() { 
/ 取消 已 设 定 的 闹钟 提醒 
mAlarmManager.cancel(pIntent); 
/ 设 定 延 迟 若干 时 间 的 一 次 性 定时 器 
ImAlarmManager.set(AlarmManagerRTC_WAKEUP, 

System.currentTime Millis()+mDelay, pIntent); 


} 

首次 进入 该 测试 页 面 , 点 击 “ 设 置 闹钟 ”按钮 后 ， 页面 每 隔 3 秒 打印 一 行 日 志 , 如 图 16-13 
所 示 。 然 后 不 取消 也 不 注销 闹钟 服务 ， 直 接 退 出 该 页 面 ， 接 着 重新 进入 测试 页 面 ， 还 没 点 击 设 
置 按钮 ， 页 面 却 已 经 在 不 断 地 刷新 日 志 了 ， 如 图 16-14 所 示 ， 很 遗憾 上 次 的 闹钟 设置 也 产生 了 
内 存 泄漏 。 





performance performance 
口 退出 时 是 否 注销 服务 口 退出 时 是 否 注销 服务 
取消 闹钟 设置 闹钟 
页 面 打开 时 间 为 : 16:56:23 页 面 打开 时 间 为 : 16:57:08 

16:56:29 设置 闵 钟 

16:56:29 闲 钟 时 间 到 达 16:57:11 六 钟 时 间 到 达 

16:56:32 闹钟 时 间 到 达 16:57:14 闹钟 时 间 到 达 

16:56:35 闲 钟 时 间 到 达 16:57:17 六 钟 时 间 到 达 








图 16-13 ”设置 闹钟 后 的 测试 页 面 图 16-14 重新 进入 测试 页 面 的 情况 
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16.2.3 ”内 存 泄漏 的 预防 


除了 上 一 小 节 给 出 的 两 个 内 存 泄漏 场景 ，App 开发 中 的 内 存 泄漏 还 常见 于 以 下 5 个 场景 : 
(1) 数据 库 查 询 操作 后 没有 关闭 游标 Cursor。 
(2) 适配器 Adapter 刷新 数据 时 没有 重用 convertView 对 象 。 
(3) Bitmap 对 象 使 用 完毕 没有 调用 recycle 方法 回收 内 存 。 
(4) Activity 引用 了 耗 时 对 象 ， 造 成 页 面 关 闭 时 无 法 释放 被 引用 的 对 象 。 
(5) 给 系统 服务 注册 了 监听 任务 ， 却 没有 及 时 注销 。 


要 想 避 免 出 现 内 存 泄漏 ， 最 好 的 办 法 是 防 患 于 未 然 。 针 对 以 上 5 个 内 存 泄漏 场景 ， 相 应 
的 预防 措施 分 别 介绍 如 下 。 

1. 关闭 游标 

游标 Cursor 不 止 用 于 数据 库 SQLite 查询 记录 , 也 可 用 于 内 容 解析 器 ContentResolver 查询 
内 容 数 据 ， 还 可 用 于 下 载 管理 器 DownloadManager 查询 下 载 进度 。 

若 要 预防 游标 产生 的 内 存 泄漏 , 则 可 在 每 次 查询 操作 结束 后 调用 Cursor 对 象 的 close 方法 
关闭 游标 。 

2. 重用 适 配 


App 往 列 表 视 图 ListView 或 网 格 视图 GridView 中 填充 数据 都 是 通过 适配器 BaseAdapter 
的 getView 方法 展示 列表 元 素 。 列 表 元 素 较 多 时 ， 系 统 只 会 加 载 屏幕 上 可 见 的 元 素 ， 其 他 元 素 
只 有 滑动 到 屏幕 区 域内 才 会 即时 加 载 并 显示 。 当 列表 元 素 多 次 处 于 “展示 一 隐藏 一 展示 一 隐 
藏 ……” 时 ， 有 必要 重用 每 个 元 素 的 视图 ， 如 果 不 重 用 ,那么 每 次 展示 可 视 元 素 都 得 重新 分 配 
视图 对 象 ， 这 便 产 生 了 内 存 泄露 。 
重用 适 配 可 先 判断 convertView 对 象 ， 如 果 该 对 象 为 空 ， 就 为 其 分 配 视 图 对 象 ， 并 调用 
setTag 方法 保存 视图 持 有 者 ; 如 果 该 对 象 非 空 ， 就 调用 getTag 方法 获取 视图 持 有 者 。 下 面 是 
重用 列表 元 素 的 代码 示例 : 
ViewHolder holder，/ 声明 一 个 视图 持 有 者 对 象 
if(convertView 一 null) { / 转换 视图 为 空 
holder= new ViewHolder0D); / 创建 一 个 新 的 视图 持 有 者 
convertView = mInflater.inflate(R.layout.list_title, null); 
holder.tv_seq = (TextView) convertView.findViewById(R.id.tv_seq); 
holderiv_title = (ImageView) convertView.findViewByld(R.id.iv_title); 
/ 将 视图 持 有 者 保存 到 转换 视图 当中 
convertView.setTag(holder); 
} else { / 转换 视图 非 空 
/ 从 转换 视图 中 获取 之 前 保存 的 视图 持 有 者 
holder = (ViewHolder) convertView.getTag(); 











} 
每 次 给 ListView 与 GridView 构造 适配器 都 要 加 入 上 述 重用 代码 , 已 经 成 了 开发 者 的 一 大 
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负担 。 所 以 Android 在 5.0 之 后 推出 了 循环 视图 RecyclerView， 它 的 适配器 自动 实现 视图 持 有 
者 ViewHolder， 无 须 开发 者 进行 重用 判断 的 处 理 ， 算 是 一 件 善事 。 


3. 回收 图 像 


Android 虽然 定义 了 Bitmap 类 ， 但 是 读 取 图 像 数据 的 底层 操作 并 非 由 Java 代码 完成 。 查 
看 SDK 源码 , 在 BitmapFactory 类 中 一 路 跟踪 到 nativeDecodeStream 函数 ,发 现 它 其 实 是 一 个 
native 方法 ， 也 就 是 该 方法 来 自 于 JNI 接口 。 既 然 Bitmap 的 图 像 数据 实际 来 自 于 C/C++ 代码 ， 
那么 确实 得 手工 释放 C/C++ 的 内 存 资 源 。 查 看 Bitmap 类 的 源码 ， 它 的 回收 方法 recycle 用 到 的 
nativeRecycle 函数 其 实 也 是 一 个 native 方法， 同样 来 自 于 JNI 接口 。 

因此 , 若 想 避 免 图 像 操 作 引 起 的 内 存 泄 漏 , 可 在 Bitmap 对 象 使 用 完毕 后 调用 recycle 方法 。 
举一反三 ， 只 要 一 个 资源 是 在 JNI 接 口中 分 配 的 ， 一 旦 不 再 使 用 该 资源 ， 就 得 手工 调用 该 资源 
对 应 的 JNI 回 收 接口 。 


4. 释放 引用 


编写 Handler 的 处 理 函数 时 ,Android Studio 提示 This Handler class should be static or leaks 
might occur， 意 思 是 这 个 类 应 该 是 一 个 静态 类 ， 和 否则 可 能 发 生 内 存 泄 漏 。 因 为 Handler 对 象 经 
常 处 理 异 步 任 务 ， 每 当 它 调用 postDelayed 方法 执行 一 个 任务 时 ， 依 据 延 迟 间 隔 都 得 等 待 一 段 
时 间 ; 倘若 活动 页 面 在 此 期 间 退 出 ， 就 会 导致 异步 任务 持 有 的 引用 无 法 回收 。 由 于 Runnable 
通常 持 有 Activity 的 引用 ， 因 此 造成 Activity 资源 都 无 法 回收 。 

上 面 的 描述 可 能 不 好 理解 ， 确 实 也 不 容易 解释 清楚 ， 还 是 直接 跳 过 烦琐 的 概念 ， 讲 讲 如 
何 解决 该 情况 的 内 存 汇 漏 问题 。 下 面 是 预防 这 种 内 存 泄漏 的 3 个 方法 : 


(1) 如 果 异 步 任务 是 由 Handler 对 象 的 postDelayed 方法 发 起 的 ， 那 么 可 用 对 应 的 
removeCallbacks 方法 回收 ， 把 消息 对 象 从 消息 队列 移 除 就 行 了 。 

(2) 按 Android 官方 的 推荐 做 法 ， 可 把 Handler 类 改 为 静态 类 ， 同 时 Handler 内 部 使 用 
WeakReference 关键 字 持 有 目标 的 引用 。 


之 所 以 使 用 静态 类 ， 是 因为 静态 类 不 持 有 目标 的 引用 ， 不 会 影响 内 存 自 动 回收 机 制 。 但 
是 不 持 有 目标 的 引用 ，Handler 内 部 就 无 法 操作 Activity 上 面 的 控件 。 为 解决 该 问题 ， 在 构造 
Handler 类 时 需要 初始 化 目标 的 弱 引 用 。 不 同 于 前 面 的 强 引用 ， 弱 引用 相当 于 一 个 指针 ， 指 针 
指向 的 地 址 随时 可 以 回收 。 这 又 带 来 一 个 新 问题 ， 即 弱 引 用 指向 的 对 象 可 能 是 空 的 ， 所 以 
Handler 内 部 在 使 用 目标 活动 前 要 先 判断 弱 引 用 对 象 是 否 为 空 。 
下 面 是 弱 引 用 处 理 器 的 定义 代码 示例 : 
/ 声明 一 个 级 引用 的 处 理 器 对 象 
private WeakHandler mHandler = new WeakHandler(this); 








// 定义 一 个 弱 引 用 的 处 理 器 ， 其 内 部 只 持 有 目标 页 面 的 弱 引用 
Private static class WeakHandler extends Handler { 

/ 声明 一 个 目标 页 面 的 弱 引 用 

public static WeakReference<ReferWeakActivity> mActivity; 
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public WeakHandler(ReferWeakActivity activity) { 
mActivity = new WeakReference<ReferWeakActivity>(activity); 
} 


/ 在 收 到 消息 时 触发 
public void handleMessage(Message msg) { 
/ 从 目标 页 面 的 弱 引 用 中 获得 一 个 实例 
ReferWeakActivity act = mActivity.get(); 
if(act!=nulD) { 
actmDesc = String.format("%s%s 打印 了 一 行 测试 日 志 \n", 
act.mDesc, DateUtil.getNowTime()); 
act.tvy_weak.setText(act.mDesc); 


(3) 把 Handler 对 象 作为 App 的 全 局 变量 ， 即 把 Handler 对 象 作为 自 定义 Application 类 

的 成 员 变 量 。 

这 样 只 要 App 在 运行 ， 该 对 象 就 一 直 存 在 。 既 然 避 免 为 Handler 对 象 重复 分 配 内存 ， 也 就 
间接 避免 了 内 存 泄漏 的 可 能 。 

5. 注销 监听 

App 的 某 些 功能 依赖 于 Android 的 系统 服务 ， 比 如 定位 功能 依赖 于 系统 的 定位 管理 器 ， 定 
时 功能 依赖 于 系统 的 闹钟 管理 器 。App 若 想 接收 系统 服务 的 消息 , 要么 注册 监听 器 ,在 回调 方 
法 中 处 理 消息 ; 要 么 注册 广播 接收 器 ,在 接收 广播 时 处 理 消息 。 既然 有 注册 操作 ， 就 存在 对 应 
注销 操作 ， 不 过 如 果 不 注意 ， 就 会 忘记 在 代码 中 做 注销 处 理 。 所 以 在 进行 页 面 编码 时 , 千 万 
要 记得 再 检查 一 遍 ， 确 保 onDestroy 方法 中 已 经 包含 相关 的 注销 代码 。 

































不 同 的 系统 服务 拥有 不 同 的 注销 方法 ， 常 见 的 系统 服务 注销 方法 见 表 16-1。 
表 16-1 常见 的 系统 服务 注销 方法 
系统 服务 的 管理 器 注销 操作 说 明 注销 函数 
AlarmManager 取消 定时 广播 cancel 
ConnectivityManager 取消 监听 网 络 状态 unregisterNetworkCallback 
DownloadManager 移 除 下 载 任务 remove 
LocationManager 取消 监听 位 置信 息 的 变化 TemoveUpdates 
LocationManager 取消 监听 定位 状态 的 变化 removeGpsStatusListener 
Notification Manager 取消 通知 cancel 
TelephonyManager 取消 监听 电话 状态 使 用 listen 方法 注册 一 个 空 事 件 
PhoneStateListener.LISTEN_NONE 

Vibrator 取消 震动 cancel 
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16.3 ”线程 地 管理 


在 批量 执行 异步 任务 时 ， 为 了 合理 、 有 效 地 利用 任务 线程 ， 需 要 引入 线程 池 统一 管理 线 
程 资 源 。 就 像 数 据 库 是 对 数据 存储 封装 一 样 ， 线 程 池 是 对 线程 执行 封装 ， 总 之 都 是 为 了 提高 系 
统 的 运行 效率 。 本 节 先 阐述 单个 线程 存在 的 问题 , 然后 依次 说 明 普 通 线程 池 和 定时 器 线程 池 的 
用 法 。 


16.3.1 普通 线程 池 


第 10 章 介绍 多 线程 时 提 到 使 用 线程 类 Thread 开启 分 线程 ,不 过 Thread 只 处 理 自身 线程 ， 
缺乏 多 个 线程 之 间 的 统一 管理 ， 会 产生 如 下 问题 : 
(1) 无 法 控制 线程 的 并 发 数 ， 一 旦 同时 启动 多 个 线程 ， 可 能 导致 程序 挂 死 。 
(2) 线程 之 间 无 法 复 用 ， 每 个 线程 都 经 历 创建 、 启 动 、 停 止 的 生命 周期 ， 资 源 开 销 不 小 。 
由 于 单线 程 管理 存在 诸多 问题 ， 因 此 异步 任务 工具 AsyncTask 给 出 了 executeOnExecutor 
方法 ， 允 许 开 发 者 指定 任务 线程 池 。 然 而 笔者 当时 已 经 指出 ，AsyncTask 自 带 的 THREAD 
POOL_EXECUTOR 依然 存在 性 能 瓶颈 。 要 想 让 线程 池 的 处 理性 能 达到 最 优 ， 还 得 根据 实际 情 
况 自 定义 线程 池 的 具体 参数 。 
Android 用 到 的 是 Java 的 线程 池 ， 由 Executors 类 创建 。 系 统 已 经 封装 好 的 线程 池 说 明 见 
表 16-2。 


表 16-2 ”已 经 封装 好 的 线程 池 说 明 


线程 池 的 创建 方法 线程 池 类 型 说 明 
newSingleThreadExecutor ExecutorService 创建 只 有 单个 线程 的 线程 池 
newFixedThreadPool ThreadPoolExecutor 创建 线程 数量 固定 的 线程 池 


newCachedThreadPool ThreadPoolExecutor 创建 无 个 数 限制 的 线程 池 
newSingleThreadScheduledExecutor | ScheduledThreadPoolExecutor ”| 创建 只 有 单个 线程 的 定时 器 线程 池 
newScheduledThreadPool ScheduledThreadPoolExecutor 创建 线程 数量 固定 的 定时 器 线程 池 


当然 , 线程 池 中 的 线程 数量 最 好 由 开发 者 分 配 ， 这 时 就 要 使 用 ThreadPoolExecutor 的 构造 
函数 构建 线程 池 对 象 。 下 面 是 构造 函数 的 参数 说 明 。 


e@ int corePoolSize: 线程 池 的 最 小 线程 个 数 。 

e int maximumPoolSize: 线程 池 的 最 大 线程 个 数 。 

elong keepAliveTime: 非 核心 线程 在 无 任务 时 的 等 待 时 长 。 若 超过 该 时 间 仍 未 分 配 任务 ， 
则 该 线程 自动 结束 。 

e TimeUnit unit: 时 间 单 位 ， 时 间 单 位 的 取 值 说 明 见 表 16-3。 
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表 16-3 ”时 间 单 位 的 取 值 说 明 


TimeUnit 类 的 时 间 单 位 
SECONDS 
MILLISECONDS 
MICROSECONDS 














BlockingQueue<Runnable> workQueue: 设置 等 待 队列 。 取 值 new LinkedBlockingQueue 
<Runnable>() 即 可 ， 默 认 表示 等 待 队列 无 穷 大 ， 此 时 工作 线程 等 于 最 小 线程 个 数 。 当 
然 也 可 在 参数 中 指定 等 待 队列 的 大 小 ， 此 时 工作 线程 数 等 于 总 任务 数 减 去 等 待 队列 大 
小 ， 工 作 线程 数位 于 最 小 线程 个 数 与 最 大 线程 个 数 之 间 。 若 计算 得 到 的 工作 线程 数 小 
于 最 小 线程 个 数 , 则 工作 线程 数 等 于 最 小 线程 个 数 ; 若 工作 线程 数 大 于 最 大 线程 个 数 ， 
则 系统 扔 出 异常 java.util.concurrent RejectedExecutionException， 并 不 会 自动 让 工作 线 
程 数 等 于 最 大 线程 个 数 。 所 以 等 待 队列 大 小 要 么 取 默 认 值 (不 设置 ) ， 要 么 设 的 尽 可 
能 大 ， 否 则 一 旦 程序 启动 大 量 线程 ， 就 会 异常 报错 。 

ThreadFactory threadFactory: 一 般 使 用 默认 值 即 可 。 


构建 线程 池 对 象 后 ， 还 可 在 代码 中 随时 调整 参数 ， 并 执行 任务 管理 操作 。 下 面 是 
ThreadPoolExecutor 的 常用 方法 说 明 。 


execute: 向 执行 队列 添加 指定 的 任务 。 

remove: 从 执行 队列 移 除 指定 的 任务 。 

shutdown: 关闭 线程 池 。 

isTerminated: 判断 线程 池 是 否 关闭 。 

setCorePoolSize: 设置 线程 池 的 最 小 线程 个 数 。 
setMaximumPoolSize: 设置 线程 池 的 最 大 线程 个 数 。 
setKeepAliveTime: 设置 非 核心 线程 在 无 任务 时 的 等 待 时 长 。 
getPoolSize: 获取 当前 的 线程 个 数 。 

getActiveCount: 获取 当前 的 活动 线程 个 数 。 


各 种 普通 线程 池 的 执行 效果 如 图 16-15 一 图 16-18 所 示 。 其 中 ， 图 16-15 为 单线 程 线程 池 的 
结果 界面 ， 因 为 是 单线 程 ， 所 以 每 隔 2 秒 打 印 一 行 日 志 ; 图 16-16 为 多 线程 (4 个 线程 ) 线程 池 
的 结果 界面 ， 因 为 有 4 个 线程 ， 所 以 每 秒 打 印 4 行 日 志 ; 图 16-17 为 无 限制 线程 池 的 结果 界面 ， 
因为 不 限制 线程 个 数 ， 所 以 一 秒 内 就 把 所 有 日 志 打 印 出 来 了 ; 图 16-18 为 自 定义 线程 (两 个 线 
程 ) 线程 池 的 结果 界面 ， 因 为 自 定义 了 两 个 线程 ， 所 以 每 秒 打 印 两 行 日 志 。 
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普通 线程 池 类 型 单线 程 线程 池 普通 线程 池 类 型 多 线程 线程 池 
17:00:52 当前 序号 是 0 16:59:52 当前 序号 是 0 
17:00:54 当前 序号 是 1 16:59:52 当前 序号 是 1 
17:00:56 当前 序号 是 2 16:59:52 当前 序号 是 2 
17:00:58 当前 序号 是 3 16:59:52 当前 序号 是 3 
17:01:00 当前 序号 是 4 16:59:54 当前 床 号 是 4 
17:01:02 当前 序号 是 5 16:59:54 当前 序号 是 5 
17:01:04 当前 序号 是 6 16:59:54 当前 序号 是 6 
17:01:06 当前 序号 是 7 16:59:54 当前 尿 号 是 7 
17:01:08 当前 序号 是 8 16:59:56 当前 厚 号 是 8 
17:01:10 当前 序号 是 9 16:59:56 当前 尿 号 是 9 
17:01:12 当前 序号 是 10 16:59:56 当前 序号 是 10 
17:01:14 当前 序号 是 11 16:59:56 当前 序号 是 11 
17:01:16 当前 序号 是 12 16.59.58 当前 序号 是 12 
17:01:18 当前 序号 是 13 16:59:58 当前 序号 是 13 
17:01:20 当前 序号 是 14 16:59:58 当前 序号 是 14 
17:01:22 当前 序号 是 15 16:59:58 当前 序号 是 15 
17:01;24 当前 序号 是 16 17:00:00 当前 序号 是 16 
17:01:26 当前 序号 是 17 17:00:00 当前 序号 是 18 
17:01:28 当前 序号 是 18 17:00:00 当前 厚 号 是 17 
17:01:30 当前 序号 是 19 17:00:00 当前 尿 号 是 19 
图 16-15 单线 程 线程 池 的 日 志 图 16-16 多 线程 线程 池 的 日 志 

普通 线程 汉 类 型 无 限制 线程 池 普通 线程 汉 类 型 自 定义 线程 池 
17:02:04 当前 厚 号 是 0 17:02:34 当前 序号 是 0 
17:02:04 当前 序号 是 1 17:02:34 当前 序号 是 1 
17.02.04 当前 序号 是 2 17:02:36 当前 序号 是 2 
17:02:04 当前 序号 是 3 17:02:36 当前 序号 是 3 
17:02:04 当前 序号 是 4 17:02:38 当前 友 号 是 4 
17:02:04 当前 友 号 是 5 17:02:38 当前 序号 是 5 
17:02:04 当前 序号 是 6 17:02.40 当前 序号 是 6 
17:02:04 当前 友 号 是 7 17:02:40 当前 序号 是 7 
17:02:04 当前 序号 是 8 17:02:42 当前 序号 是 8 
17:02:04 当前 序号 是 9 17:02:42 当前 序号 是 9 
17:02:04 当前 序号 是 10 17:02:44 当前 序号 是 10 
17:02:04 当前 序号 是 11 17:02.44 当前 夯 号 是 11 


17:02:04 当前 序号 是 12 
17:02:04 当前 序号 是 13 
17:02:04 当前 友 号 是 14 
17:02:04 当前 序号 是 15 
17:02.04 当前 序号 是 16 
17:02:04 当前 序号 是 17 
17:02:04 当前 序号 是 18 


17:02.04 当前 序号 是 19 17:02.52 当前 序号 是 19 











图 16-17 无 限制 线程 池 的 日 志 图 16-18” 自 定义 线程 池 的 日 志 
16.3.2 ”定时 器 线程 池 


前 面 的 普通 线程 池 是 立即 执行 任务 (如 果 有 空余 线程 》， 但 有 时 我 们 并 不 希望 任务 立即 
执行 ， 而 是 延迟 一 段 时 间 再 执行 ， 这 样 便 用 到 了 定时 器 线程 池 。 

Android 同样 提供 了 封装 好 的 两 个 定时 器 线程 池 ， 即 newScheduledThreadPool 和 
newSingleThreadScheduledExecutor, 详细 说 明 见 表 16-2。 当 然 现 有 的 定时 器 线程 池 并 不 总 能 满 
足 需求 ,还 得 由 开发 者 自行 定制 。 具 体 说 来 ， 就 是 使 用 ScheduledThreadPoolExecutor 的 构造 函 
数 构建 定时 器 线程 池 对 象 。 下 面 是 构造 函数 的 参数 说 明 。 

e int corePoolSize: 线程 池 的 最 小 线程 个 数 。 

eThreadFactory threadFactory: 一 般 使 用 默认 值 即 可 。ThreadFactory 是 在 线程 池 中 使 用 的 

线程 工厂 接口 ， 定 义 了 一 个 newThread 方法 ， 该 方法 输入 Runnable 参数 ， 返 回 Thread 
对 象 。 虽然 一 般 情况 下 使 用 默认 的 DefaultThreadFactory 即 可 ， 但 是 在 某 些 特定 场合 可 
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以 自己 实现 工厂 类 ,用 来 跟踪 线程 的 启动 时 间 、 结 束 时 间 ， 以 及 线程 发 生 异 常 时 的 处 理 
步骤 。 

。 RejectedExecutionHandler handler: 一 般 使 用 默认 值 即 可 。 

定时 器 线程 池 ScheduledExecutorService 继承 了 ThreadPoolExecutor 的 所 有 方法 。 下 面 是 

定时 器 线程 池 多 出 的 几 个 定时 器 相关 方法 。 

eschedule: 延迟 一 段 时 间 后 启动 任务 。 

e@ scheduleAtFixedRate: 先 延迟 一 段 时 间 ， 然 后 间隔 若干 时 间 周 期 启动 任务 。 

e@ scheduleWithFixedDelay: 先 延 迟 一 段 时 间 ， 然 后 固定 延迟 若干 时 间 启 动 任务 。 


注意 ，scheduleAtFixedRate 和 scheduleWithFixedDelay 都 是 循环 执行 任务 ， 区 别 在 于 前 者 
的 间隔 时 间 从 上 个 任务 的 开始 时 间 起 计算 ， 后 者 的 间隔 时 间 从 上 个 任务 的 结束 时 间 起 计算 。 
定时 器 线程 池 的 执行 效果 如 图 16-19 和 图 16-20 所 示 。 其 中 ， 图 16-19 为 单线 程 的 定时 器 
线程 池 ， 每 隔 2 秒 打 印 一 行 日 志 ; 图 16-20 为 多 线程 (3 个 线程 ) 的 定时 器 线程 池 ， 因 为 有 3 
个 线程 ， 所 以 每 秒 打印 3 行 日 志 。 
performance 


定时 器 线程 池 类 型 。 ”单线 程 定时 器 固定 速率 













定时 器 线程 池 关 型 。 ”多 线程 定时 器 固定 速率 


17:24:44 当前 序号 是 0 


17:23:55 当前 序号 是 0 
17:23:55 当前 序号 是 1 
17:23:55 当前 序号 是 2 
17:23:58 当前 序号 是 0 
17:23:58 当前 序号 是 1 
17:23:58 当前 序号 是 2 
17:24:01 当前 序号 是 0 
17:24:01 当前 序号 是 1 
17:24:01 当前 序号 是 2 


16-19 单线 程 定时 器 线程 池 的 日 志 图 16-20 多 线程 定时 器 线程 池 的 日 志 








16.4 ”省 电 模 式 


现在 手机 的 电池 容量 越 来 越 大 ， 电 量 消耗 的 速度 也 越 来 越 快 ， 往 往 使 用 一 两 天 手机 就 没 
电 了 。 电 量 跟 流量 是 用 户 很 关心 的 两 个 重要 指标 。 一 个 App 乱 跑 流 量 ， 很 容易 遭 到 用 户 抛弃 ; 
同样 ， 一 个 App 若是 耗 电大 户 ， 也 难以 逃脱 被 卸载 的 命运 。 所 以 App 开发 要 注意 适当 省 电 ， 
本 节 从 电量 检测 与 熄 屏 检测 两 方面 论述 如 何 开 启 自 动 省 电 模式 , 以 及 如 何在 休眠 模式 下 合理 运 
行 App。 


16.4.1 检测 当前 电量 


Android 获取 当前 电量 是 通过 监听 广播 实现 的 。 有 具体 地 说 ， 是 监听 电池 的 电量 改变 事件 ， 
即 Intent.ACTION_BATTERY_CHANGED。 因 为 接收 该 事件 要 求 App 处 于 活动 状态 ， 所 以 广 
播 接收 器 不 能 在 AndroidManifest.xml 中 注册 ， 只 能 在 代码 中 通过 registerReceiver 方法 动态 注 
册 。 注 册 完 成 即 可 监听 电量 变化 广播 ， 该 广播 携带 的 参数 信息 见 表 16-4。 
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表 16-4 电量 变化 广播 中 携带 的 参数 信息 





















































BatteryManager 类 的 字段 名 称 字段 获取 方法 说 明 
EXTRA_SCALE getIntExtra 电量 刻度 ， 通 常 是 100 
EXTRA_LEVEL getIntExtra 当前 电量 
EXTRA STATUS getIntExtra 当前 状态 
BATTERY _STATUS_ UNKNOWN 当前 状态 取 值 未 知 
BATTERY _STATUS_ CHARGING 当前 状态 取 值 正在 充电 
BATTERY STATUS _DISCHARGING 当前 状态 取 值 正在 断 电 
BATTERY STATUS NOT_CHARGING 当前 状态 取 值 不 在 充电 
BATTERY STATUS_ FULL 当前 状态 取 值 电量 充满 
EXTRA_HEALTH getIntExtra 健康 程度 
BATTERY_ HEALTH_UNKNOWN 健康 程度 取 值 未 知 
BATTERY_HEALTH_GOOD 健康 程度 取 值 良好 
BATTERY_HEALTH_OVERHEAT 健康 程度 取 值 过 热 
BATTERY_HEALTH DEAD 健康 程度 取 值 坏 了 
BATTERY_HEALTH_ OVER _ VOLTAGE 健康 程度 取 值 短路 
BATTERY_HEALTH_UNSPECIFIED_FAILURE | 健康 程度 取 值 未 知 错误 
BATTERY_HEALTH_COLD 健康 程度 取 值 冷却 
EXTRA_VOLTAGE getIntExtra 当前 电压 
EXTRA_PLUGGED getIntExtra 当前 电源 
0 当前 电源 取 值 电池 
BATTERY_PLUGGED AC 当前 电源 取 值 充电 器 
BATTERY_PLUGGED _USB 当前 电源 取 值 USB 
BATTERY_PLUGGED WIRELESS 当前 电源 取 值 无 线 
EXTRA_TECHNOLOGY getStringExtra 当前 技术 , 比如 返回 Li-ion 
表示 锂电 池 
EXTRA_TEMPERATURE getIntExtra 当前 温度 
EXTRA_PRESENT getBooleanExtr 是 否 提供 电池 


检测 当前 电量 的 代码 没什么 技术 含量 ， 


电器 时 的 界面 。 








只 是 简单 地 把 电量 变化 广播 中 携带 的 参数 信息 打 
印 出 来 ， 读 者 可 参考 本 书 附带 源码 performance 模块 的 BatteryInfoActivityjava。 电 量 检测 的 效 
果 如 图 16-21 和 图 16-22 所 示 。 其 中 ， 图 16-21 为 正在 充电 时 的 界面 ， 图 16-22 所 示 为 拔 出 充 
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performance performance 


18:17:07 : 收 到 广 18:17:23 : 收 到 广 
播 : android.intent.action.BATTERY_CHANGE 播 : android intent action .BATTERY_CHANGE 
D D 








图 16-21 正在 充电 时 的 电量 信息 图 16-22 没 在 充电 时 的 电量 信息 
16.4.2 ”检测 屏幕 开关 


大 家 很 关心 如 何 给 App 减负 、 省 电 ， 前 人 也 做 了 不 少 总 结 工作 ， 基 本 的 判断 原则 是 : 越 
消耗 资源 的 App， 耗 电量 就 越 大 。 具 体 到 代码 编写 主要 有 以 下 省 电 措施 : 


(1) 能 用 整 型 数 计算 就 不 用 浮 点 数 计算 。 

(2) 能 用 JSON 解析 就 不 用 XML 解析 。 

(3) 能 用 网 络 定位 就 不 用 GPS 定位 。 

(4) 尽量 减少 大 文件 的 下 载 ( 如 先 压缩 再 下 载 、 缓 存 已 下 载 的 文件 )。 

(5) 用 完 系 统 资源 要 及 时 回收 。 

(6) 能 用 线程 处 理 就 不 用 进程 处 理 。 

(7) 多 用 缓存 复 用 对 象 资源 。 如 屏幕 尺寸 只 需 获取 一 次 ， 之 后 可 到 缓存 中 读 取 。 
(8) 能 用 定时 器 广播 就 不 用 后 台 常 驻 服 务 。 

(9) 能 用 内 存 存储 就 不 用 文件 存储 。 


上 述 省 电 措施 虽然 有 效 ， 但 是 比 起 耗 电 大 户 ， 还 是 小 巫 见 大 巫 。 在 实际 开发 中 ， 耗 电大 
户 其 实 是 后 台 默 默 运 行 的 Service 服务 。 想 想 看 ， 手 机 待机 时 ， 屏 幕 都 不 亮 了 ， 手 机 里 面 还 有 
- 些 不 知 疲倦 的 Service 在 “愚公移山 ”， 轴 公 也 是 要 吃饭 的 呀 。 
既然 如 此 ， 若 想 避 免 App 在 手机 待机 时 仍 在 做 无 用 功 ， 可 在 熄 屏 时 结束 指定 任务 ， 在 亮 
屏 时 再 开始 指定 任务 。 其 中 ， 熄 屏 事 件 监 听 的 是 系统 广播 IntentACTION_SCREEN_OFF， 亮 
屏 事 件 监 听 的 是 系统 广播 Intent.ACTION_SCREEN_ON。 
在 具体 的 编码 中 ， 监 听 这 两 个 屏幕 事件 需要 注意 以 下 3 点 : 


(1) 熄 屏 事 件 和 亮 屏 事件 必须 在 代码 中 动态 注册 。 如 果 在 AndroidManifest.xml 中 静态 注 
册 ， 就 不 起 任何 作用 。 

(2) 在 炸 屏 时 ， 系 统 先 暂停 所 有 活动 页 面 ， 然 后 才 关 闭 屏幕 : 同样 ， 在 亮 屏 时 ， 系 统 先 
点 亮 屏幕 ， 然 后 才 恢 复活 动 页 面 。 故 而 这 两 个 事件 不 能 在 Activity 代码 中 注册 和 注销 ， 只 能 在 
自 定义 Application 类 的 onCreate 方法 中 注册 广播 接收 器 。 

(3) 活 动 页 面 要 想 得 知 屏幕 开关 的 事件 信息 , 必须 通过 自 定义 的 Application 类 间接 获取 。 


检测 屏幕 开关 事件 的 代码 如 下 : 
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public class MainApplication extends Application { 
/ 声明 一 个 当前 应 用 的 静态 实例 
private static MainApplication mApp; 
private String mChange = ""; 


/ 利用 单 例 模式 获取 当前 应 用 的 唯一 实例 

public static MainApplication getInstance() { 
Tetum mApp; 

} 


// 获取 屏幕 事件 的 文字 描述 
public String getChangeDescO { 
return mApp.mChange; 


/ 设置 屏幕 事件 的 文字 描述 

public void setChangeDesc(String change) { 
mApp.mChange = mApp.mChange + change; 

} 


public void onCreate() { 
super.onCreate(); 
/ 在 打开 应 用 时 对 静态 的 应 用 实例 赋值 
mApp = this; 
/ 创建 一 个 锁 屏 事件 的 广播 接收 器 
LockScreenReceiver lockReceiver = new LockScreenReceiver(); 
/ 创建 一 个 意图 过 滤器 
IntentFilter filter = new IntentFilter(); 
/ 给 意图 过 滤器 添加 亮 屏 事件 
filter.addAction(Intent.ACTION_SCREEN_ON); 
/ 给 意图 过 滤器 添加 熄 屏 事件 
filteraddAction(Intent.ACTION SCREEN_OFF); 
/ 给 意图 过 滤器 添加 用 户 解锁 事件 
filteraddAction(Intent.ACTION_USER_PRESENT); 
/ 注册 广播 接收 器 ， 注 册 之 后 才能 正常 接收 广播 
registerReceiver(lockReceiver, filter); 


} 


// 定义 一 个 锁 屏 事件 的 广播 接收 器 
Private class LockScreenReceiver extends BroadcastReceiver { 
/ 一 旦 接收 到 锁 屏 状态 发 生变 化 的 广播 ， 马 上 触发 接收 器 的 onReceive 方法 
public void onReceive(Context context, Intent intent) { 
if (intent {= null) { 
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String change = ""; 
change = String.format("%sn%s : 收 到 广播 : %s", change, 
DateUtil.getNowTime(), intent.getAction()); 

if (intent.getAction().equals(Intent.ACTION_SCREEN ON) { 

/ 接收 到 亮 屏 广播 

change = String.format("%s\n 这 是 屏幕 点 亮 事件 , 可 在 此 开启 日 常 操 作 ", change); 
} else if (intent.getAction().equals(Intent.ACTION_SCREEN OFF) { 

/ 接收 到 熄 屏 广播 

change = String.format("%s\n 这 是 屏幕 关闭 事件 , 可 在 此 暂停 耗 电 操作 ", change); 
} else if (intent.getAction().equals(Intent. ACTION_USER PRESENT)) { 

// 接收 到 解锁 广播 

change = String.format("%sin 这 是 用 户 解锁 事件 ", change); 
} 
/ 更 新 屏幕 变化 事件 的 文字 描述 
MainApplication.getInstance().setChangeDesc(change); 


} 
屏幕 检测 的 效果 如 图 16-23 所 示 ， 能 够 正确 检测 到 熄 屏 事件 和 亮 屏 事件 , 才 可 执行 后 台 服 
务 的 停止 与 启动 操作 。 


performance 


18:17:39 : 收 到 广 

播 : android.intent.action.SCREEN_OFF 
这 是 屏幕 关闭 事件 ， 可 在 此 暂停 耗 电 操作 
18:17:43 : 收 到 广 

播 : android.intent.action.SCREEN_ON 

这 是 屏幕 点 亮 事件 ， 可 在 此 开启 日 常 操作 





图 16-23 ”测试 应 用 监测 到 了 炸 屏 事件 和 亮 屏 事件 
16.4.3 ”休眠 模式 对 App 的 影响 


定时 器 AlarmManager 常常 用 于 需要 周期 性 处 理 的 场合 ， 比 如 闹钟 提醒 、 任 务 轮 询 等 。 并 
且 定 时 器 来 源 于 系统 服务 ， 即 使 App 已 经 不 在 运行 了 ， 也 能 收 到 定时 器 发 出 的 广播 而 被 唤醒 。 
似 此 回光返照 的 神 技 ， 便 遭 到 开发 者 的 滥用 , 造成 用 户 手机 充斥 着 各 种 杀 不 光 的 进程 ， 就 算 通 
过 手机 安全 工具 一 再 地 清理 内 存 ， 只 要 定时 设 定 的 时 刻 到 达 ， 刚 杀 掉 的 流氓 App 也 会 死 灰 复 
燃 。 长 此 以 往 ， 手 机 的 运行 速度 越 来 越 慢 ， 内 存 也 越 来 越 不 够 用 了 ， 更 糟糕 的 是 ， 电 量 消耗 也 
越 来 越 快 。 

Android 手机 越 用 越 慢 的 毛病 老大 不 掉 ， 为 此 每 次 系统 版 本 升级 ，Android 都 力图 在 稳定 
性 、 安 全 性 上 有 所 改善 。 针 对 定时 器 AlarmManager 的 滥用 问题 ，Android 从 4.4 开始 ， 修 改 了 
setRepeating 方法 的 运行 规则 。 原本 该 方法 可 指定 每 隔 固定 时 间 就 发 送 定时 广播 , 但 在 Android 
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4.4 之 后 ,操作 系统 为 了 节能 省 电 , 将 会 自动 调整 定时 器 唤醒 的 时 间 。 比 如 原来 调用 setRepeating 
方法 设 定 了 每 隔 10 秒 发 送 广播 ， 但 App 在 实际 运行 过 程 中 ， 很 可 能 过 了 好 几 分 钟 才 发 送 一 次 
广播 ， 这 意味 着 该 方法 将 不 再 保证 每 次 工作 都 在 开发 者 设置 的 时 间 开 始 。 
正如 前 面 “16.2.2 内 存 汇 漏 的 预防 ”小 节 描 述 的 那样 ， 当 时 为 了 演示 定时 器 发 生 内 存 泄 
漏 的 场景 ， 并 没有 直接 调用 setRepeating 方法 ， 而 是 接力 调用 set 方法 。App 每 次 收 到 定时 广 
播 之 后 ， 还 得 重新 开始 下 一 次 的 定时 任务 ， 如 此 方 可 兼容 Android 4.4 之 后 的 持续 定时 功能 。 
下 面 是 将 setRepeating 方法 改 为 使 用 set 方法 实现 的 代码 示例 : 

/ 声明 一 个 闹钟 广播 事件 的 标识 串 

private String ALARM EVENT = "com.example.performance.alarm"; 

private static AlarmManager mAlarmManager; / 声明 一 个 闹钟 管理 器 对 象 

private static PendingIntent pIntent; / 声明 一 个 延迟 意图 对 象 

private static int mDelay = 3000; ”// 闹钟 延迟 的 间隔 














// 设置 定时 任务 ， 注 意 setRepeating 的 时 间 间 隔 并 不 可 靠 ， 只 能 调用 set 方法 间接 实现 定时 
private void setAlarm() { 

// 创建 一 个 广播 事件 的 意图 

Intent intent = new Intent(ALARM_ EVENT); 

/ 创建 一 个 用 于 广播 的 延迟 意图 

pItent = PendingIntent.getBroadcast(this, 0, intent PendingIntent.FLAG_UPDATE CURRENT); 

// 从 系统 服务 中 获取 闹钟 管理 器 

mAlarmManager = (AlarmManager) getSystemService(ALARM_ SERVICE); 

1/ 在 API19( 即 Android 4.4) 之 后 ， 操 作 系统 为 了 节能 省 电 ， 会 调整 alarm 唤醒 的 时 间 ， 

// 所 以 setRepeating 方法 不 保证 每 次 工作 都 在 指定 的 时 间 开 始 ， 

// 此 时 需要 先 注销 原 闹 钟 ， 再 调用 set 方法 开启 新 疗 钟 

//mAlarmManager.setRepeating(AlarmManager.RTC_WAKEUP, 

/I/ System.currentTimeMillis(), mDelay, plIntent); 

// 设 定 延迟 若干 时 间 的 一 次 性 定时 器 

ImAlarmManagerset(AlarmManagerRTC_WAKEUP, System.currentTimeMillisO0+mDelay pIntent); 
} 


// 定义 一 个 定时 广播 的 接收 器 
public static class AlarmReceiver extends BroadcastReceiver { 
// 一 旦 接收 到 闹钟 时 间 到 达 的 广播 ， 马 上 触发 接收 器 的 onReceive 方法 
public void onReceive(Context context, Intent intent) { 
if (intent != nulD) { 
if (tv_alarm !=nulD) { 
mDesc = String.format("%sn%s 闹钟 时 间 到 达 " mDesc, DateUtil.getNowTime()); 
tv_alarm.setText(mDesc); 
repeatAlarm(); / 设置 下 一 次 的 定时 任务 
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} 


// 每 次 时 刻 到 达 ， 都 重新 设置 下 一 次 的 定时 任务 ， 从 而 间接 实现 了 持续 唤醒 的 功能 
private static void repeatAlarm() { 
// 取消 原 有 的 定时 任务 
mAlarmManager.cancel(pIntent); 
/ 开启 新 的 定时 任务 
mAlarmManager.set(AlarmManager.RTC WAKEUP., System.currentTimeMillisO+mDelay pIntent); 

lb 

上 面 瞒天过海 的 办 法 看 似 完美 规避 了 Android 4.4 的 运行 规则 ， 可 惜 广大 开发 者 还 没 来 得 
及 沾沾自喜 ，Android 6.0 又 推出 了 更 加 严格 的 休眠 模式 。 所 谓 休眠 模式 ， 即 是 当 手 机 屏幕 关 
闭 的 时 候 〈 又 称 熄 屏 、 暗 屏 ) ， 系 统 就 会 自动 开启 休眠 模 式 ， 这 样 原本 正在 运行 的 App 将 进 
入 挂 起 模式 ， 不 能 再 进行 访问 网 络 等 常用 操作 。 当 然 为 了 保证 App 不 被 完全 挂 死 ， 系 统 也 会 
定期 退出 休眠 模式 ， 好 比 青蛙 从 冬眠 之 中 苏醒 过 来 ， 在 苏醒 期 间 ， 系 统 允许 挂 起 的 App 重新 
恢复 运行 ， 继 续 先 前 设 定好 的 任务 。 可 是 这 个 苏醒 期 是 短暂 的 (通常 只 有 几 秒 ) ， 一 旦 苏醒 期 
结束 ， 系 统 又 重新 进入 休眠 模式 ， 于 是 那些 App 再 次 挂 起 ， 等 待 下 次 苏醒 期 的 到 来 ， 如 此 往 
复 。 当然, 只 要 手机 恢复 亮 屏 ， 比 如 用 户 按 下 电源 键 、 用 户 给 手机 插 上 电源 、 手 机 接 到 来 电 等 ， 
系统 便 自 动 退出 休眠 模式 ， 所 有 挂 起 的 App 都 会 恢复 正常 运转 。 

手机 在 休眠 期 间 ， 之 前 通过 定时 器 的 set 方法 设 定 好 的 定时 任务 ， 即 使 定时 的 时 刻 到 达 ， 
也 必须 等 到 苏醒 期 间 才 会 得 到 执行 。 如 果 一 定 要 在 手机 休眠 的 时 候 唤 醒 闹 钟 ， 就 得 调用 
setAndAllowWhileldle 代替 set 方法 , 或 者 调用 setExactAndAllowWhileldle 代替 setExact 方法 。 
其 中 setAndAllowWhileldle 与 setExactAndAllowWhileldle 这 两 个 方法 是 Android 从 6.0 开始 新 
增 的 定时 方法 , 字面 意思 是 即使 正在 休眠 也 要 执行 定时 任务 。 然 而 休眠 模式 的 本 意 是 挂 起 包括 
定时 任务 在 内 的 App 事务 ， 现 在 却 提供 setAndAllowWhileldle 方法 留 下 了 后 门 ， 为 开发 者 的 
鸡 鸣 狗 盗 之 事 大 开 方 便 ， 如 此 规定 岂 不 是 贻 笑 大 方 ? 

这 光景 ， 简 直 是 活脱 脱 的 一 出 Android 版 本 的 自 相 了 矛盾， 话说 Android 设计 师 当街 叫卖 
Android 的 安全 盾 , 号 称 这 面 盾 很 牢固 、 没 有 矛 可 以 刺 穿 ; 前 来 踢 馆 的 开发 者 拿 着 一 把 Android 
的 setRepeating 矛 ,说 道 这 把 矛 可 以 穿 过 那 面 盾 。 设 计 师 眼看 不 妙 ,赶忙 拿 起 另 一 面 名 叫 Android 
4.4 的 安全 盾 ， 又 称 你 的 setRepeating 矛 不 行 了 ;， 开发 者 精明 得 很 ， 随 身 抄 着 一 把 Android 的 
set 矛 ， 又 道 这 把 矛 可 以 破 了 那 面 Android 4.4 的 盾 。 设 计 师 火 冒 三 丈 ， 心 想 岂 能 甘 拜 下 风 ， 于 
是 拿 出 一 面 Android 6.0 的 休眠 盾 ， 声 称 有 此 盾 护 身 不 怕 set 矛 ; 谁 料 道 高 一 尺 、 魔 高 一 丈 ， 
发 者 夺 过 一 把 Android 出 产 的 setAndAllowWhileIdle 矛 , 依旧 能 刺 开 Android 6.0 休眠 盾 。 结果 
Android 设计 师 大 汗 淋 注 ， 却 不 肯 认 输 ， 嘴 里 碎 碎 念 : “此 山 是 我 开 ， 此 树 是 我 栽 ， 要 从 此 路 
过 ， 留 下 买 路 财 。 罢 了 罢了 ， 十 管 你 的 予 有 多 锋利 ， 反 正 我 规定 休眠 盾 至 少 能 抗 住 九 分 钟 。” 
这 里 的 九 分 钟 参 见 Android 官方 说 明 : Neither setAndAllowWhileldle() nor 
setExactAndAllowWhileldle() can fire alarms more than once per 9 minutes, per app， 意 思 是 不 管 
是 setAndAllowWhileldle 还 是 setExactAndAllowWhileldle, 在 休眠 期 内 每 个 App 每 隔 9 分 钟 最 
多 只 能 唤醒 一 次 闹钟 。 

方面 要 照顾 用 户 的 手机 省 电 需 求 ， 另 一 方面 要 考虑 开发 者 的 业务 实现 , 开发 Android 的 
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谷歌 公司 真是 煞费苦心 , 只 可 异 鱼 与 能 掌 不 可 兼 得 。 我 们 作为 开发 者 , 要 让 定时 器 适 配 Android 
6.0 的 休眠 模式 倒 也 不 难 ， 只 需 把 下 面 这 行 的 set 方法 代码 : 


/ 设 定 延迟 若干 时 间 的 一 次 性 定时 器 
mAlarmManager.set(AlarmManager.RTC WAKEUP., System.curentTimeMillisO+mDelay pIntent); 
改 成 下 面 兼 容 6.0 的 代码 就 好 了 : 
if (Build.VERSION.SDK_INT >= Build.VERSION CODES.M) { 
// Android 6.0 之 后 增强 了 休眠 模式 ， 手 机 在 休眠 期 间 ， 
/ 原本 在 系统 闹钟 服务 AlarmManager 中 设 定好 的 定时 任务 ， 
/ 即使 定时 的 时 刻 到 达 ， 也 要 等 到 苏醒 期 间 才 会 得 到 执行 。 
/ 如 果 一 定 要 在 休眠 期 唤醒 闹钟 ， 就 得 调用 setAndAllowWhileIdle 代替 set 方法 。 
/ 但 即使 是 setAndAllowWhileIdle 方法 ，App 每 9 分 钟 唤醒 次 数 也 不 能 超过 一 次 
mAlarmManager.setAndAllowWhileldle(Alarm Manager.RTC_ WAKEUP, 
System.currentTimeMillis()}+mDelay, pIntent); 
}else{ 
// 设 定 延迟 若干 时 间 的 一 次 性 定时 器 
mAlarmManager.set(AlarmManager.RTC_ WAKEUP, System.currentTimeMillisO+mDelay, pIntent); 
} 


其 实 就 是 判断 当前 系统 版 本 ， 对 于 Android 6.0 及 以 上 版 本 ， 使 用 setAndAllowWhileldle 
方法 替换 set 方法 即 可 。 


16.5 “实战 项 目 : 网 络 图 片 缓存 框架 


性 能 优化 说 来 说 去 ， 归 根 到 底 是 用 最 少 的 资源 换取 最 高 的 效率 ， 也 就 是 看 哪个 性 价 比 最 
高 。 在 性 能 优化 的 诸多 措施 中 ， 性 价 比 最 高 的 当 数 图 片 缓存 ，App 要 想 既 好 看 又 丰富 ， 都 是 靠 
大 量 图 片 堆砌 出 来 的 。 与 其 纠结 HTTP 交互 文本 采用 JSON 格式 好 还 是 采用 XML 格式 好 ， 还 
不 如 好 好 研究 图 片 缓存 技术 , 一 张 图 片 的 运算 量 远 远 超过 一 段 文本 。 况且 图 片 缓存 不 但 可 以 加 
快运 行 速度 ， 而 且 能 节省 流量 ， 还 能 省 电 ， 从 而 极 大 改善 用 户 体验 。 本 章 以 “图 片 缓存 框架 ” 
实战 项 目 作 为 结尾 。 


16.5.1 设计 思 


第 4 章 的 实战 项 目 “ 购 物 车 ”中 已 经 出 现 了 图 片 缓存 的 雏形 ， 当 时 的 图 片 缓存 只 有 两 级 ， 
即 “ 全 局 内 存 ” 一 “SD 卡 文件 ”。 实 际 开发 中 的 图 片 缓存 至 少 为 3 级 ， 即 “内 存 ” 一 “SD 
卡 ” 一 “网 络 ”。 正 常情 况 下 ，App 先 到 内 存 中 寻找 图 片 ， 如 果 找 到 ， 就 直接 显示 内 存 中 的 图 
片 。 如 果 在 内 存 中 没 找到 图 片 ， 再 到 SD 卡 寻找 。 如 果 在 SD 卡 找到 图 片 ， 就 读 取 SD 卡 图 片 
并 显示 。 如 果 在 SD 卡 也 没 找 到 ， 就 得 根据 URL 去 网 络 下 载 图 片 ， 下 载 成 功 后 再 显示 图 片 。 
经 过 3 级 缓存 查找 ， 即 使 网 速 很 慢 甚 至 断 网 ，App 也 能 迅速 加 载 大 部 分 图 片 ， 使 得 用 户 的 浏览 
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操作 基本 不 受 影响 。 

当然 ， 图 片 缓存 技术 主要 在 后 台 实现 ， 普 通用 户 不 容易 感觉 到 它 的 存在 。 不 过 只 要 稍 加 
注意 ， 你 也 能 发 现 界面 上 采用 图 片 缓存 的 端倪 。 如 果 一 张 图 片 以 灰 度 动画 逐渐 显示 时 ， 很 可 能 
就 是 通过 缓存 技术 加 载 的。 图 16-24 和 图 16-25 分 别 展示 了 图 片 加 载 的 开始 与 完成 界面 ， 图 
16-24 中 的 玫瑰 花 尚且 腊 腊 肛 肛 、 若 隐 若 现 ， 提 示 用 户 当 前 图 片 正 在 加 载 ， 加 载 完毕 后 ， 整 张 
玫瑰 花 图 片 清 晰 地 显示 出 来 ， 如 图 16-25 所 示 。 


performance performance 


占 位 加 载 列表 加 载 占 位 加 载 列表 加 载 
月 坛 公园 的 玫瑰 花 盛开 啦 月 坛 公园 的 玫瑰 花 盛开 啦 





图 16-24 玫瑰 花 图 片 正在 加 载 图 16-25 ”玫瑰 花 图 片 加 载 完 成 

在 技术 上 ， 灰 度 动画 开始 时 ， 整 张 图 片 已 经 下 载 完成 。 之 所 以 加 入 动画 的 渐变 效果 ， 是 

为 了 留 出 缓冲 的 过 程 , 让 用 户 不 至 于 觉得 图 片 一 闪 一 内 很 突 元 。 接 下 来 看 图 片 缓存 框架 用 到 了 
哪些 App 技术 。 


(1) 图 像 视图 ImageView: 无 论 多 么 高 深 的 框架 ， 都 要 打 好 基础 。 

(2) 灰 度 动画 AlphaAnimation: 通过 渐变 效果 展示 图 片 加 载 的 过 程 ， 用 到 了 灰 度 动画 。 

(3) 图 片 的 基本 加 工 : 有 时 为 了 减少 资源 占用 , 仅 需 展 示 缩 略图 , 用 户 有 需要 再 显示 大 图 。 

(4) 内 存 的 读 写 : 多 张 图 片 保 存在 缓存 队列 中 ， 要 求 有 合适 的 数据 结构 进行 管理 。 

(5) SD 卡 的 文件 读 写 : 从 网 络 下 载 的 图 片 先 保存 在 SD 卡 ， 再 依 情况 决定 是 否 加 载 进 内 存 。 

(6) HTTP 访问 : 从 网 络 获取 图 片 ， 可 直接 从 HTTP 地 址 读 取 图 片 数据 。 

(7) 多 线程 : 网 络 访问 请 求 ， 需 要 开启 分 线程 处 理 ， 并 操作 Handler 对 象 。 

(8) 线程 池 : 页 面 同时 请 求 多 张 图 片 ， 需 要 线程 池 统一 管理 图 片 下 载 的 各 线程 资源 。 

(9) 内 存 泄 漏 : 频繁 操作 Handler 对 象 ， 要 及 时 释放 该 对 象 的 引用 。 另 外 ， 对 Bitmap 对 
象 也 要 注意 加 以 回收 。 


上 面 一 口气 列举 了 这 么 多 知识 点 ， 原 来 图 片 缓存 是 一 个 综合 技术 活 ， 可 算是 集 Android 技术 
大 全 了 。 只 要 理解 图 片 缓存 的 算法 ， 并 加 以 实践 将 其 做 好 ， 就 差不多 可 以 掌握 半 部 App 的 开发 。 


16.5.2 ”小 知识 : LRU 缓存 策略 




















读者 也 许 还 记得 大 学 里 操作 系统 课程 中 的 页 面 置 换算 法 ， 说 的 是 操作 系统 发 现 要 访问 的 
数据 在 内 存 中 找 不 到 , 只 好 把 内 存 中 很 久 没 用 的 页 面 踢 出 去 , 以 便 给 本 次 访问 的 数据 让 出 存储 
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室 间 。 图 片 缓存 的 排队 算法 类 似 页 面 置 换算 法 , 常见 的 主要 有 两 种 :FIFO 先进 先 出 算法 和 LRU 
最 和 久未 使 用 算法 。FIFO 算法 比较 容易 实现 ， 只 要 把 数据 按时 间 先 后 顺序 排队 ， 要 淘汰 老 旧 数 
据 时 ， 只 需 把 队列 最 前 端的 数据 移 除 即 可 。 因 为 图 片 缓存 的 FIFO 算法 需要 对 队列 两 端 进 行 操 
作 ， 从 队列 顶端 移 除 淘汰 的 图 像 ， 并 把 新 增 的 图 像 加 到 队列 末端 , 所 以 该 算法 的 缓存 结构 可 采 
用 双 端 队列 LinkedList。 

麻烦 的 是 LRU 算法 ， 虽 然 该 算法 在 实际 开发 中 用 得 最 多 ， 缓 存 效果 也 最 好 ， 但 Java 却 没 
提供 该 算法 对 应 的 数据 结构 。 幸 好 Android 在 设计 之 初 已 经 考虑 了 该 问题 ， 提 供 了 LruCache 
缓存 工具 ,方便 开发 者 实现 LRU 算法 的 相关 缓存 业务 。LruCache 内 部 集成 了 缓存 数据 的 插入 
时 间 判 断 , 无 论 缓存 内 部 是 否 已 经 存在 某 键 值 ， 新 插入 的 键 数据 总 是 位 于 缓存 队列 尾部 ， 如 此 
开发 者 不 必 关 心 具体 的 排队 淘汰 逻辑 ， 只 需 进 行 App 的 业务 处 理 就 好 。 

下 面 是 LruCache 的 常用 方法 说 明 。 


构造 函数 : 初始 化 指定 大 小 的 缓存 队列 。 
resize: 变更 缓存 队列 的 大 小 。 
put: 往 缓存 队列 插入 数据 。 
get: 从 缓存 队列 获取 数据 。 
remove: 把 指定 数据 移出 缓存 队列 。 
evictAll: 清空 缓存 队列 。 
size: 获得 已 使 用 的 缓存 队列 大 小 。 
maxSize: 获得 缓存 队列 的 总 大 小 。 
snapshot: 获得 缓存 队列 的 快照 ， 即 获取 缓存 队列 当前 的 映射 表 。 
可 以 看 出 ，LruCache 的 用 法 与 Java 的 容器 类 差不多 ， 但 有 两 个 不 同 点 值得 注意 一 下 : 
(1) LruCache 未 提供 contains 函数 用 于 判断 某 键 值 是 否 存在 ， 只 能 调用 get 函数 间接 判 
断 。 即 检查 get 函数 的 返回 值 ， 如 果 返 回 null 就 表示 缓存 中 不 存在 该 键 值 。 
(2) LruCache 不 能 直接 进行 遍历 操作 ， 只 能 调用 snapshot 函数 获得 当前 快照 ， 再 遍历 快 
照 中 的 映射 表 Map。 
接 下 来 通过 实际 代码 加 深 对 LruCache 的 理解 ， 示 例 代 码 如 下 : 


public class LruCacheActivity extends AppCompatActivity implements OnClickListener { 
private TextView tv_lru_cache; 
private LruCache<String, String> mLanguageLru; / 声明 一 个 最 近 最 少 使 用 算法 的 缓存 对 象 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_lru_cache); 
tv_lru cache = findViewById(R.id.tv_lru_cache); 
findViewByld(R.id.btn_android).setOnClickListener(this); 
findViewByld(R.id.btn_ios).setOnClickListener(this); 
findViewById(R.id.btn_java).setOnClickListener(this); 
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findViewById(R.id.btn_cpp).setOnClickListener(this); 
findViewById(R.id.btn_python).setOnClickListener(this); 
findViewBylId(R.id.btn_net).setOnClickListener(this); 
findViewById(R.id.btn_php).setOnClickListener(this); 
findViewById(R.id.btn_perl).setOnClickListener(this); 

/ 创建 一 个 大 小 为 5 的 LRU 缓存 

mLanguageLru = new LruCache<String, String>(5); 


public void onClick(View v) { 
String language = ((Button) v).getText().toString(); 
/ 往 LRU 缓存 上 添加 一 条 新 的 语言 记录 ， 具 体 的 排队 操作 由 LrmCache 内 部 自动 完成 
mLanguageLru.put(language, DateUtil.getNowTime()); 
printLruCache0; / 打印 LRU 缓存 中 的 数据 
b 


// 打印 LRU 缓存 中 的 数据 
private void printLruCacheO { 
String desc = ""; 
/ 获取 LRU 缓存 在 当前 时 刻下 的 快照 映射 
Map<String, String> cache = mLanguageLru.snapshot(); 
for (Map.Entry<String, String> item : cache.entrySet()) { 
desc = String.format("%s%s 最 后 一 次 更 新 时 间 为 %s\n"， 
desc, item.getKey(), item.getValue()); 
} 


tv_lru_cache.setText(desc); 


} 

上 述 代码 运行 后 的 效果 如 图 16-26 一 图 16-29 所 示 。 其中, 图 16-26 为 LRU 缓存 在 某 个 时 
刻 的 快照 ， 此 时 Android 位 于 队列 顶端 然后 点 击 ANDROID 按钮 ， 表示 现在 已 访问 Android， 
于 是 Android 从 队列 顶端 移 到 了 队列 底部 ， 并且 插入 时 间 也 被 更 新 了 ， 此 时 队列 顶端 的 数据 变 
成 了 iOS， 如 图 16-27 所 示 。 








performance performance 
ANDROID 1I0S JAVA C/C++ ANDROID I0S JAVA C/C++ 
PYTHON NET PHP PERL PYTHON NET PHP PERL 


Android 最 后 一 次 更 新 时 间 为 17:05:01 
iDS 最 后 一 次 更 新 时 间 为 17:05:03 
JAVA 最 后 一 次 更 新 时 间 为 17:05:05 
C/C++ 最 后 一 次 更 新 时 间 为 17:05:07 
Python 最 后 一 次 更 新 时 间 为 17:05:09 





图 16-26 LRU 缓存 队列 里 的 初始 数据 


i0S 最 后 一 次 更 新 时 间 为 17:05:03 
JAVA 最 后 一 次 更 新 时 间 为 17:05:05 
C/C++ 最 后 一 次 更 新 时 间 为 17:05:07 
Python 最 后 一 次 更 新 时 间 为 17:05:09 
Android 最 后 一 次 更 新 时 间 为 17:05:45 





16-27 点 击 Android 后 的 缓存 队列 


接着 点 击 PHP 按钮 ， 表 示 访 问 PHP 语言 ， 于 是 PHP 被 插入 到 缓存 队列 底部 ， 同 时 顶端 
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的 iOS 被 移出 队列 ， 此 时 队列 顶端 的 数据 变 成 了 JAVA， 如 图 16-28 所 示 。 然 后 点 击 JAVA 按 
钮 ， 表 示 访 问 Java 语言 ， 于 是 Java 从 队列 顶端 移 到 了 队列 底部 ， 而 且 更 新 了 插入 时 间 ， 此 时 
队列 项 端的 数据 变 成 了 C/C++， 如 图 16-29 所 示 。 














performance 
ANDROID Ios JAVA C/C++ ANDROID Ios JAVA C/C++ 
PYTHON .NET PHP PERL PYTHON -NET PHP PERL 

JAVA 最 后 一 次 更 新 时 间 为 17:05:05 C/C++ 最 后 一 次 更 新 时 间 为 17:05:07 

C/C++ 最 后 一 次 更 新 时 间 为 17:05:07 Python 最 后 一 次 更 新 时 间 为 17:05:09 

Python 最 后 一 次 更 新 时 间 为 17.05:09 Android 最 后 一 次 更 新 时 间 为 17:05:45 

Android 最 后 一 次 更 新 时 间 为 17:05:45 PHP 最 后 一 次 更 新 时 间 为 17:07:15 

PHP 最 后 一 次 更 新 时 间 为 17:07:15 JAVA 最 后 一 次 更 新 时 间 为 17:07:43 

图 16-28 点 击 PHP 后 的 LRU 缓存 队列 图 16-29 点 击 JAVA 后 的 LRU 缓存 队列 


16.5.3 ”代码 示例 


编码 与 测试 方面 需要 注意 以 下 3 点 : 


(1) AndroidManifest.xml 注意 声明 相关 权限 ， 举 例如 下 : 


<!-- 上 网 --> 

<uses-permission android:name="android.permission.INTERNET" /> 

DE > 

<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.MOUNT _UNMOUNT FILESYSTEMS"/> 


(2) 除了 普通 控件 的 图 片 缓存 ， 还 要 实现 列表 视图 里 的 图 片 缓存 。 因 为 ListView 只 会 加 
载 当前 屏幕 上 可 见 的 列表 元 素 , 通过 不 断 上 拉 与 下 拉 ListView, 可 以 观察 图 片 缓存 是 否 正常 工 
作 ， 以 及 是 否 发 生 内 存 泄漏 的 情况 。 


(3) 使 用 真 机 对 联网 与 断 网 两 种 情况 分 别 进行 测试 。 
最 后 是 图 片 缓存 框架 的 演示 时 间 ， 在 加 载 图 片 前 ， 通 常 在 原 图 位 置 放 一 张 占 位 图 片 ， 如 


图 16-30 所 示 。 如 果 图 片 加 载 失败 ， 就 在 原 图 位 置 显示 出 错 图 片 ， 提 示 用 户 原 图 加 载 失 败 ， 如 
图 16-31 所 示 。 





占 位 加 载 列表 加 堵 占 位 加 载 列表 加 载 
月 坛 公园 的 玫瑰 花 感 开 恰 月 坛 公园 的 玫瑰 花 盛开 恰 


馈 区 sm .mssT7 











16-30 加载 前 先 显示 占 位 图 片 图 16-31 ”加载 失败 显示 出 错 图 片 
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在 联网 的 情况 下 ， 只 要 图 片 地 址 准确 ， 图 片 缓存 框架 便 能 正常 工作 。 一 旦 从 “内 存 ” 一 
“SD 卡 ” 一 “网 络 ”3 级 缓存 中 取 到 图 片 ， 便 可 通过 渐变 动画 展示 图 片 。 如 图 16-32 所 示 ， 
此 时 动画 开始 ， 图 片 正 逐 步 变 亮 ， 等 到 动画 结束 ， 图 片 揭 开 面纱 呈现 出 来 ， 如 图 16-33 所 示 。 








performance performance 


占 位 加 载 列表 加 载 占 位 加 载 列表 加 载 
月 坛 公园 的 玫瑰 花 盛开 啦 月 坛 公园 的 玫瑰 花 盛开 啦 














图 16-32 渐变 动画 正在 播放 图 16-33 ”渐变 动画 结束 播放 
再 来 看 图 片 缓存 在 列表 视图 中 是 如 何 工 作 的 。 如 图 16-34 所 示 ， 一 打开 ListView 图 片 列 
表 页 面 , 处 于 屏幕 可 视 区 域 的 前 两 张 图 片 就 开始 加 载 ; 待 加 载 完毕 , 这 两 张 图 片 清晰 展现 开 来 ， 
如 图 16-35 所 示 。 
然后 把 页 面 拉 到 底部 ， 原 本 处 于 不 可 见 区 域 的 最 后 两 项 开始 加 载 ， 图 片 逐渐 变 亮 ， 如 图 
16-36 所 示 ; 最 终 这 两 张 图 片 完整 无 缺 地 显示 出 来 ， 如 图 16-37 所 示 。 





performance performance 
占 位 加 载 列表 加 载 占 位 加 载 列表 加 载 
欢迎 来 到 风景 秀美 的 鼓浪屿 欢迎 来 到 风景 秀美 的 鼓浪屿 
™ 

















图 16-34 ”列表 视图 头 部 图 片 开始 加 载 图 16-35 ”列表 视图 头 部 图 片 结束 加 载 
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performance 


performance 


占 位 加 载 列表 加 载 
欢迎 来 到 风景 秀美 的 鼓浪屿 
| 了 下 -人 


有 这 





| 


二 
Bhd Pau lL 











Was 
在 “ mi 
一 El "A 
图 16-36 列表 视图 底部 图 片 开始 加 载 图 16-37 列表 视图 底部 图 片 结束 加 载 


看 起 来 是 不 是 很 神奇 ? 图 片 缓存 框架 的 用 法 很 简单 ， 先 设置 好 各 项 缓存 的 处 理 参数 ， 然 
后 调用 show 方法 即 可 。 下 面 是 该 缓存 框架 的 调用 代码 示例 : 

// 创建 一 个 新 的 图 片 缓存 配置 

ImageCacheConfig config = new ImageCacheConfig.Builder() 
.setBeginImage(R.drawable.load_default) / 设置 加 载 开始 前 的 图 片 资源 编号 
.setErrorImage(R.drawable.load_error) / 设置 加 载 失败 后 的 图 片 资源 编号 
.setCacheStyle(ImageCacheConfig.LRU) // 设置 图 片 缓存 的 排队 算法 
.setFadeDuration(2000).build0; / 设置 淡 入 动画 的 播放 时 长 

/ 初始 化 图 片 缓存 的 配置 ， 并 给 图 像 视图 加 载 网 络 图 片 

mCache.initConfig(config).show(file, iv_cache); 


图 片 缓存 框架 的 核心 处 理 代 码 如 下 ， 完 整 的 框架 代码 参见 本 书 附带 源码 performance 模块 
的 com.example.performance.cache 包 里 面 的 几 个 java 文件 : 


public class ImageCache { 
/ 内 存 中 的 图 片 缓存 
private HashMap<String, Bitmap> mImageMap = new HashMap<String, Bitmap>(); 
/ 图 片 地 址 与 视图 控件 的 映射 关系 
private HashMap<String, ImageView> mViewMap = new Hash Map<String, ImageView>(); 
/ 缓存 队列 ， 采 用 FIFO 先进 先 出 策略 ， 需 操作 队列 首尾 两 端 ， 故 采用 双 端 队列 
private LinkedList<String> mFifoList = new LinkedList<String>(); 
// 缓存 队列 ， 采 用 LRU 近期 最 少 使 用 策略 ，Android 专门 提供 了 LruCache 实现 该 算法 
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private LruCache<String, Bitmap> mImageLru; 

private ImageCacheConfig mConfig; / 声明 一 个 图 片 缓存 配置 对 象 
private String mDir= "%; / 缓存 图 片 的 文件 目录 

private ThreadPoolExecutor mPool; // 声明 一 个 线程 池 对 象 

private static Handler mHandler;，// 声明 一 个 泻 染 处 理 器 对 象 
private static ImageCache mCache = null; / 声明 一 个 图 片 缓存 对 象 
private static Context mContext; // 声明 一 个 上 下 文 对 象 


// 通过 单 例 模式 获得 图 片 缓存 的 唯一 实例 
public static ImageCache getInstance(Context contexb { 
if (mCache — null) { 
mCache = new ImageCache(); 
mCache.mContext = context; 
FE 
return mCache; 


f 


/ 初始 化 图 片 缓存 的 配置 
public ImageCache initConfig(ImageCacheConfig config) { 
mCache.mConfig = config; 
mCache.mDir = mCache.mConfig.mDir; 
if (mCache.mDir 一 null | mCache.mDir.length() <= 0) { 
/ 生成 缓存 图 片 的 文件 目录 
mCache.mDir = mContext.getExternalFilesDir( 
Environment.DIRECTORY_ DOWNLOADS).toString() + "/image_cache"; 
} 
/ 车 目录 不 存在 ， 则 先 创建 新 目录 
File dir = new File(mCache.mDir); 
if (Idir.exists|)) { 
dir.mkdirs(); 
}; 
// 创建 一 个 固定 大 小 的 线程 池 
mCache.mPool = (ThreadPoolExecutor) 
Executors.newFixedThreadPool(mCache.mConfig.mThreadCount); 
mCache.mHandler = new RenderHandler((Activity) mCache.mContext); 
/ 如 果 采 用 最 近 最 少 使 用 算法 ， 则 要 设 定 LruCache 缓存 的 大 小 
if (mCache.mConfig.mCacheStyle 一 ImageCacheConfig.LRU) { 
mImageLru = new LruCache(mCache.mConfig.m MemoryFileCount); 
} 
return mCache; 


b 


/ 往 图 像 视图 上 加 载 网 络 图 片 
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public void show(String url, ImageView iv) { 
iv.setImageDrawable(null); 
if (mConfig.mBeginImage {= 0) { 
// 加 载 操作 前 先 显示 开始 图 片 
iv.setImageResource(mConfig.mBeginImage); 
} 
mViewMap.put(url, iv); 
让 (isExist(url)) { // 内 存 中 已 存在 该 图 片 
/ 直接 渲染 该 图 片 
mCache.render(url, getBitmap(url)); 
} else { // 内 存 中 不 存在 该 图 片 
String path = getFilePath(url); 
让 (Cnew File(path)).exists()) { // 磁盘 上 已 存在 该 图 片 
1/ 从 图 片 文件 中 读 取 位 图 数据 
Bitmap bitmap = ImageUtil.openBitmap(path); 
if (bitmap {= nulD { 
// 直接 泻 染 该 图 片 
mCache.render(url, bitmap); 
} else { 
/ 命令 线程 池 启 动 图 片 加 载 任务 
mpPool.execute(new LoadRunnable(urD); 
1 
} else { / 磁盘 上 不 存在 该 图 片 
/ 命令 线程 池 启动 图 片 加 载 任务 
mpPool.execute(new LoadRunnable(url)); 


) 


/ 判断 内 存 中 是 否 已 存在 该 图 片 
private boolean isExist(String url) { 
让 (mCache.mConfigmCacheStyle 一 ImageCacheConfig.LRU) { / 最 近 最 少 使 用 算法 
return (mImageLru.get(url) 一 null) ? false : true; 
}else { // 先进 先 出 算法 
return mImageMap.containsKey(url); 
上 
} 


/ 根据 图 片 地 址 获取 内 存 中 的 位 图 数据 
private Bitmap getBitmap(String urD { 
让 (mCache.mConfigmCacheStyle 一 ImageCacheConfig.LRU) { / 最 近 最 少 使 用 算法 
return mImageLru.get(url); 
} else { // 先进 先 出 算法 
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return mImageMap.get(url); 
! 


/ 根据 图 片 地 址 生成 对 应 的 图 片 路 径 
private String getFilePath(String url) { 

return String.format("%s/%d.jpg", mDir, url.hashCode()); 
b 


// 定义 一 个 演 染 处 理 器 ， 用 于 在 UI 主线 程 中 演 染 图 片 
private static class RenderHandler extends Handler { 
public static WeakReference<Activity> mActivity; 
public RenderHandler(Activity activity) { 
mActivity = new WeakReference<Activity>(activity); 


由 


public void handleMessage(Message msg) { 
Activity act= mActivity.get(); 
if (act!=nulD) { 
ImageData data = (ImageData) (msg.obj); 
让 (data != null && data.bitmap != null) { // 已 获得 位 图 数据 
// 直接 泻 染 该 图 片 
mCache.render(data.url, data.bitmap); 
} else { // 未 获得 位 图 数据 
// 加 载 失败 ， 则 显示 错误 图 片 
mCache.showError(data.url); 


} 


/ 定义 一 个 图 片 加 载 任务 
private class LoadRunnable implements Runnable { 
Private String mUrl; 
public LoadRunnable(String url) { 
mUrl = url: 


b 


public void run() { 
Activity act = RenderHandler.mActivity.get(); 
if(act!=nulD) { 
/ 从 图 片 网 址 处 获得 位 图 数据 
Bitmap bitmap = ImageHttp.getImage(mUzr); 
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让 (bitmap {=null) { 
// 如 果 需 要 缩 略 图 ， 则 对 位 图 对 象 进 行 缩放 操作 
if (mConfig.mSize != null) { 
bitmap = Bitmap.createScaledBitmap(bitmap, 
mConfig.mSize.x, mConfig.mSize.y, false); 
} 
/ 把 位 图 数据 保存 为 图 片 文件 
ImageUtil.saveBitmap(getFilePath(mUrl), bitmap); 
!; 
ImageData data = new ImageData(mUrl, bitmap); 
// 下 面 把 图 片 加 载 信息 送 给 泻 染 处 理 器 
Messagemsg = mHandler.obtainMessage(); 
msg.obj = data; 
mHandler.sendMessage(msg); 


b 


// 在 界面 上 演 染 位 图 图 片 
Private void render(String url, Bitmap bitmap) { 
ImageView iv = mViewMap.get(url); 
让 (mConfig.mFadeDuration <= 0) { / 无 需 展示 淡 入 动画 
iv.setImageBitmap(bitmap); 
} else { // 需要 展示 淡 入 动画 
if(isExist(urD)) { // 内 存 中 已 有 图 片 的 ， 就 直接 显示 
iv.setImageBitmap(bitmap); 
} else { / 内 存 中 未 有 图 片 的 ， 就 展示 淡 入 动画 
iv.setAlpha(0.0f); 
// 下 面 通过 灰 度 动画 来 展示 图 像 视图 的 图 片 淡 入 效果 
AlphaAnimation alphaAnimation = new AlphaAnimation(0.0f, 1.0f); 
alphaAnimation.setDuration(mConfig.mFadeDuration); 
alphaAnimation.setFillAfter(true); 
iv.setImageBitmap(bitmap); 
iv.setAlpha(1.0f); 
iv.setAnimation(alphaAnimation); 
alphaAnimation.start(); 
/ 刷新 图 片 缓存 内 部 的 排队 队列 
mCache.refreshList(url, bitmap); 


b 


/ 刷新 图 片 缓存 内 部 的 排队 队列 
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private synchronized void refreshList(String url, Bitmap bitmap) { 
让 (mCache.mConfigmCacheStyle 一 ImageCacheConfig.LRU) { / 最 近 最 少 使 用 算法 
/ 更 新 LruCache 缓存 
mlmageLru.put(url, bitmap); 
} else { // 先进 先 出 算法 
让 (mFifoList.size() >= mConfigmMemoryFileCount) { // 已 超过 内 存 中 的 文件 数量 限制 
/ 移 除 双 端 队列 开头 的 小 伙伴 
String out_url = mFifoL ist.pollFirst(); 
mIlmageMap.remove(out_url); 
和 
mImageMap.put(url, bitmap); 
/ 往 双 端 队列 末尾 插入 新 的 小 伙伴 
mFifoList.addLast(url); 


h 


// 显示 加 载 失败 后 的 错误 图 片 
private void showError(String urD { 
ImageView iv = mViewMap.get(url); 
if (mConfig.mErrorImage != 0) { 
iv.setImageResource(mConfig.mErrorImage); 
} 
1 


/ 清空 图 片 缓存 
public void clear0 { 
/ 回收 图 片 缓存 中 的 所 有 位 图 对 象 
for (Map.Entry<String, Bitmap> item_map : mImageMap.entrySet()) { 
Bitmap bitmap = item_map.getValue(); 
bitmap.recycle(); 
bp 
mImageMap.clear0; / 清空 位 图 映射 
mViewMap.clear0; / 清空 视图 映射 
mFifoList.clear0; / 清空 双 端 队列 
if (mImageLru !=nulD { 
mlImageLru.evictAll(); // 清空 LruCache 缓存 


b 
mCache = null; 
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16.6 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 常见 性 能 优化 技术 ,包括 布局 文件 优化 (减少 重复 布局 、 
自 适 应 调整 布局 、 自 定义 窗口 主题 ) 、 内 存 泄 漏 处 理 〈 内 存 泄漏 的 检测 、 内 存 泄 漏 的 发 生 、 内 
存 泄漏 的 预防 》、 线 程 池 管理 〈 普 通 线程 池 、 定 时 器 线程 池 ) 、 省 电 模 式 〈 检 测 当 前 电量 、 检 
测 屏幕 开关 、 休 眠 模式 下 的 定时 器 处 理 ) 。 最 后 设计 了 一 个 实战 项 目 “ 图 片 缓存 框架 ”， 在 该 
项 目的 App 编码 中 采用 了 本 书 讲述 的 与 存储 和 多 线程 有 关 的 主要 技术 。 另 外 ， 介 绍 了 LRU 组 
存 策略 的 原理 与 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 5 种 开发 技能 : 


(1) 学 会 使 用 布局 文件 优化 技术 统一 界面 风格 。 

(2) 学 会 检测 内 存 泄漏 的 情况 ， 并 采取 相应 的 预防 措施 。 
(3) 学 会 有 效 使 用 和 管理 线程 池 。 

(4) 学 会 针对 省 电 模 式 以 及 休眠 模式 的 优化 处 理 。 

(5) 学 会 图 片 缓存 框架 的 基本 原理 和 具体 实现 。 


附录 一 ， 仿 流行 App 的 常用 功能 


本 书 的 一 大 特色 是 突出 实战 ， 介 绍 App 开发 技术 时 往往 结合 具体 案例 ， 故 而 全 书 分 布 着 


许多 实用 技巧 。 为 了 更 方便 地 检索 这 些 喜闻乐见 的 功能 实现 ,下 面 总 结 了 两 个 索引 表格 以 绘 读 





























者 。 
附 表 1-1 仿 电 商 App 和 社交 App 的 常见 功能 

章节 标题 功能 说 明 
3.7 “实战 项 目 : 登录 App 仿 电 商 App 的 登录 页 面 
4.6 ”实战 项 目 ， 购物 车 仿 电 商 App 的 购物 车 页 面 
5.4.3 ”改进 的 启动 引导 页 仿 电 商 App 的 启动 引导 页 
5.6.2 ”小 知识 ， 月 份 选择 器 MonthPicker 仿 支付 宝 的 账单 月 份 
7.1.2 ”实现 底部 标签 栏 仿 电 商 App 的 标签 栏 
7.2.4 ”标签 布局 TabLayout 仿 京东 的 商品 与 详情 页 
7.3.2 ”实现 横幅 轮 播 Banner 仿 电 商 App 的 活动 Banner 
7.3.3 ” 仿 京东 项 到 头 部 的 Banner 仿 京东 项 到 头 部 的 Banner 
7.4.3 ”动态 更 新 循环 视图 仿 微 信 的 公众 号 消息 列表 
7.6 ”实战 项 目 : 仿 支付 宝 的 头 部 伸缩 特效 仿 支付 宝 的 首页 头 部 
7.7 ”实战 项 目 : 仿 淘宝 主页 仿 淘宝 首页 
9.3.2” 摇 一 摇 一 一 加 速度 传感器 仿 微 信 的 摇 一 摇 
9.6 “实战 项 目 : 仿 微 信 的 发 现 功能 仿 微 信 的 扫 一 扫 
10.2.4 HTTP 图 片 获 取 仿 电 商 App 的 验证 码 刷新 
10.6 ”实战 项 目 ; 仿 手机 QQ 的 聊天 功能 仿 手机 QQ 的 聊天 功能 
11.4.3 ”正常 下 拉 与 下 拉 刷 新 的 冲突 处 理 仿 京东 首页 的 下 拉 刷 新 
12.4.4 ” 仿 支 付 宝 的 支付 成 功 动画 仿 支 付 宝 的 支付 成 功 动 画 





16.5 ”实战 项 目 :网络 图 片 缓存 框架 


仿 电 商 App 的 图 片 缓存 
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附 表 1-2 ”单独 实现 的 趣味 小 应 用 
































章节 标题 应 用 名 称 
2.5 ”实战 项 目 : 简单 计算 器 简单 计算 器 
3.6 ”实战 项 目 : 房贷 计算 器 房贷 计算 器 
5.6 ”实战 项 目 : 万 年 历 万 年 历 

5.7 ”实战 项 目 : 日 程 表 日 程 表 

6.6 “实战 项 目 : 手机 安全 助手 手机 安全 助手 
9.3.3 ”指南针 一 一 磁场 传感器 指南 针 

9.6 “实战 项 目 : 仿 微 信 的 发 现 功能 博 饼 游戏 
9.6 ”实战 项 目 : 仿 微 信 的 发 现 功 能 卫星 浑 天 仪 
10.5 ”实战 项 目 ， 仿 应 用 宝 的 应 用 更 新 功能 应 用 超市 
11.5 实战 项 目 : 抠 图 神器 一 一 美 图 变 变 抠 图 工具 
11.6 实战 项 目 ; 虚拟 现实 的 全 景 图 库 全 景 照片 查看 器 
11.6.2 小 知识 : 三 维 图 形 接口 OpenGL 地 球 仪 

12.6 ”实战 项 目 ， 仿 QQ 空间 的 动感 影集 动感 影集 
13.1.3 图片 查看 器 一 一 青青 相册 相册 

13.5 “实战 项 目 ， 影视 播 放 器 一 一 爱 看 剧场 影视 播放 器 
13.6 ”实战 项 目 ， 音 乐 播放 器 一 一 浪花 音乐 音乐 播放 器 
14.1.3 ”简单 浏览 器 网 页 浏览 器 
14.5 ”实战 项 目 ， 共享 经 济 弄 潮 儿 一 一 WiFi 共享 器 WiFi 热点 共享 器 
14.6 ”实战 项 目 ， 笔 黑 飘 香 之 电子 书架 电子 书 阅 读 器 
15.5 ”实战 项 目 ， 仿 滴 滴 打 车 打车 App 


附录 二 Android 各 版 本 的 新 增 功能 说 明 


本 书 采用 的 Android 最 低 系 统 版 本 号 为 4.1 (API 代号 16) ， 然 而 4.1 之 后 的 各 个 版 本 又 


陆续 增加 了 不 少 新 功能 ， 为 了 把 这 些 新 增 功能 与 对 应 的 系统 版 本 梳理 


Android 4.2 到 Android 8.0 之 间 系 统 功 能 增强 的 索引 表格 。 


附 表 2-1 Android 4.2 的 功能 变化 
章节 标 系统 变更 的 功能 


渚 机 
清楚 ， 


下 面 罗 列 了 从 








8.2.3 ”数据 加 密 修改 了 AES 加 密 的 强 随机 种 子 算法 


附 表 2-2 Android 4.3 的 功能 变化 


章节 标题 


系统 变更 的 功能 





9.5.3 ”蓝牙 BlueTooth 


增加 了 蓝牙 管理 器 BluetoothManager， 支 持 BLE 








12.3.3 ”插值 器 和 估 值 器 


增加 了 和 拢 形 估 值 器 RectEvaluator 





附 表 2-3 Android 4.4 的 功能 变化 


章节 标题 系统 变更 的 功能 





7.3.3 ” 仿 京 东 项 到 状态 栏 的 Banner 开始 支持 悬浮 状态 栏 ， 又 称 沉浸 状态 栏 





9.3.4 计 步 器 、 感 光 器 和 陀螺 仪 增加 了 计 步 器 Sensor.TYPE_STEP_DETECTOR 





9.5.2 ”红外 遥控 增加 了 红外 遥控 管理 器 ConsumerIrManager 





12.3.2 属性 动画 组 合 增加 了 属性 动画 的 暂停 方法 pause 和 恢复 方法 resume 








16.4.3 ”休眠 模式 对 App 的 影响 定时 管理 器 的 setRepeating 方法 在 暗 屏 后 失效 


附 表 2-4 Android 5.0 的 功能 变化 


章节 标题 系统 变更 的 功能 





6.4.4 ” 自 定义 通知 消息 的 文本 颜色 设 定 修改 了 通知 栏 的 默认 标题 风格 





7.3.3 ” 仿 京东 顶 到 状态 栏 的 Banner 

9.1.4 使 用 Camera2 拍照 

13.4.4 ”截图 和 录 屏 

14.6.2 小 知识 : ”PDF 文件 泻 染 器 PdfRenderer 


开始 支持 给 顶部 状态 栏 着 色 

增加 了 二 代 相 机 系列 Camera2 

增加 了 媒体 投影 管理 器 MediaProjectionManager 
增加 了 PDF 文件 泻 染 器 PdfRenderer 








附 表 2-5 Android 6.0 的 功能 变化 

系统 变更 的 功能 

增加 了 运行 时 权限 校 验 与 申请 
搜索 蓝牙 设备 需要 添加 定位 权限 


章节 标题 
9.1.5 运行 时 动态 授权 管理 
9.5.3 蓝牙 BlueTooth 





12.4.4” 仿 支付 宝 的 支付 成 功 动画 增加 了 矢量 动画 监听 器 AnimationCallback 





16.4.3 ”休眠 模式 对 App 的 影响 增加 了 定时 管理 器 的 setAndAllowWhileldle 方法 





附 表 2-6 Android 7.0 的 功能 变化 











章节 标题 系统 变更 的 功能 
4.3.2 ”公有 存储 空间 与 私有 存储 空间 默认 不 允许 访问 公共 空间 
8.2.3 数据 加 密 修改 了 AES 加 密 的 强 随 机 种 子 算法 
10.3.1 下 载 管理 器 DownloadManager | 下 载 管理 器 的 COLUMN_LOCAL_FILENAME 字段 被 废弃 
13.4.1 分 屏 一 一 多 窗口 模式 增加 了 分 屏 模式 的 配置 及 其 适 配 处 理 
附 表 2-7 Android 8.0 的 功能 变化 
章节 标题 系统 变更 的 功能 





6.4.1 通知 推送 Notification 消息 通知 需要 指定 渠道 编号 才能 推送 





10.5.2 ”小 知识 : 查看 APK 文件 的 包 信息 增加 了 新 的 权限 设置 “安装 其 他 应 用 ” 





13.4.2” 画 中 画 一 一 特殊 的 多 窗口 增加 了 画 中 画 模式 的 配置 及 其 适 配 处 理 





14.3.3 ”开关 热点 普通 应 用 不 再 允许 操作 热点 
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附 表 2-8 Android 9.0 的 功能 变化 

















章节 标题 系统 变更 的 功能 

5.5.2 ”定时 器 AlarmManager | 静态 注册 的 广播 全 面 失 效 

6.5.2 ”推送 服务 到 前 台 增加 了 新 的 权限 设置 “前 台 服务 ” 

8.2.3 ”数据 加 密 彻底 删除 密 钥 提供 者 Crypto 及 其 SHA1PRNG 算法 

12.1.2 ”显示 GIF 动画 增加 了 图 像 解码 器 ImageDecoder， 并 支持 播放 GIF 和 WebP 动 图 


附录 三 ”手机 硬件 与 App 开发 的 关联 


谚 云 : 内 行 看 门道 、 外 行 看 热闹 。 手 机 厂商 每 推出 一 款 新 手机 ， 都 会 大 力 宣扬 相关 卖点 ， 
诸如 处 理 器 速度 更 快 、 内 存 容 量 更 大 、 相 机 拍摄 更 清晰 、 电 池 续 航 更 持久 ， 还 有 NFC、 陀 螺 
仪 、 指 纹 识 别 此 类 黑 科 技 等 , 总 之 吹 得 天 花 乱 坠 , 把 消费 者 搞 得 云 里 筋 里 的 。 对 于 开发 者 来 说 ， 
可 不 能 像 普 通用 户 那 样 人 云 亦 云 ， 而 要 知 其 然 、 知 其 所 以 然 ， 不 但 要 了 解 这 些 硬 件 是 用 来 干 什 
么 的 ， 还 要 知晓 每 种 硬件 都 对 应 哪个 App 开发 技术 。 俗 话说 : 光 说 不 练 假 把 式 ， 光 练 不 说 俐 
把 式 ， 能 说 能 练 才 是 真 功 夫 。 所 以 下 面 整 理 了 几 个 表格 ， 尝 试 理 清 手 机 上 的 硬件 与 App 开发 
之 间 的 技术 关联 关系 。 


附 表 3-1 手机 芯片 及 其 对 App 开发 的 影响 











芯片 类 别 章节 标题 

ROM 闪存 4.3.1 SD 卡 基 本 操作 

NFC 模块 9.5.1 ”NFC 近 场 通信 

蓝牙 模块 9.5.3 ”蓝牙 BlueTooth 

导航 模块 9.6.2 ”小 知识 : 全 球 卫星 导航 系统 
CPU 中 央 处 理 器 10.1.3 ”异步 任务 AsyncTask 

WiFi 模 块 14.3.1 无 线 网 络 管理 器 WifiManager 
RAM 运 存 16.2.1 内 存 泄漏 的 检测 


附 表 3-2 手机 外 设 及 其 对 App 开发 的 影响 




















外 设 名 称 章节 标题 

屏幕 2.1.3 ”屏幕 分 辩 率 

数据 线 8.1.2 ” 真 机 调试 

摄像 头 9.1.2 ”使 用 Camera 拍照 

麦克 风 9.2.2 音量 控制 

陀螺 仪 9.3.4 计 步 器 、 感 光 器 和 陀螺 仪 
红外 发 射 器 9.5.2 ”红外 遥控 





电池 16.4.1 ”监测 当前 电量 
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附录 四 ”专业 术语 索引 


本 书 作为 一 本 软件 开发 方面 的 专著 ， 不 可 避免 地 采用 了 大 量 的 专业 术语 简称 ， 为 了 让 读 
者 更 准确 地 理解 这 些 英文 简称 背后 的 涵义 ， 下 面 列举 了 一 些 与 App 开发 有 关 的 常见 术语 。 


附 表 4-1 App 开发 常见 的 专业 术语 






























































术语 简称 术语 全 称 说 明 

3GPP 3rd Generation Partnership Project 第 三 代 合作 伙伴 项 目 计划 
A2DP Advanced Audio Distribution Profile 蓝牙 音频 传输 模型 协定 

AAC Advanced Audio Coding 高 级 音频 编码 

AES Advanced Encryption Standard 高 级 加 密 标准 

AI Artificial Intelligence 人 工 智能 

AMR Adaptibve Multi-Rate 自 适应 多 速率 ， 一 种 音频 格式 
APK Android Package 安 卓 应 用 的 安装 包 

AR Augmented Reality 增强 现实 

AS Android Studio 安 卓 工作 室 

AVI Audio Video Interleaved 音频 视频 交错 格式 ， 一 种 视频 格式 
BDS BeiDou Navigation Satellite System 北斗 卫星 导航 系统 〈 中 国 ) 
BLE Bluetooth Low Energy 蓝牙 低能 耗 

CPU Central Processing Unit 中 央 处 理 器 

EPUB Electronic Publication 电子 出 版 标准 ， 一 种 电子 书 格式 
FIFO First Input First Output 先进 先 出 算法 

GIF Graphics Interchange Format 图 像 互 换 格式 ， 一 种 动 图 格式 
GPS Global Positioning System 全 球 定位 系统 (美国 ) 

GPU Graphics Processing Unit 图 形 处 理 器 

GUI Graphical User Interface 图 形 用 户 界面 

HTMEL HyperText Markup Language 超 文 本 标记 语言 

HTTP HyperText Transfer Protocol 超 文 本 传输 协议 

IEEE Institute of Electrical and Electronics Engineers | 电气 和 电子 工程 师 协会 

IoT Internet of Things 物 联网 

R Infrared Radiation 红外 线 ， 红 外 通讯 

JDK Java Development Kit Java 开发 工具 包 

JNI Java Native Interface Java 原生 接口 

JPEG Joint Photographic Experts Group 联合 图 像 专家 小 组 ， 一 种 图 片 格式 
JSON JavaScript Object Notation JavaScript 对 象 表示 法 

LRU Least Recently Used 最 近 最 少 使 用 算法 

MAC 地址 | Media Access Control Address 媒体 访问 控制 地 址 

MD5 Message-Digest Algorithm 5 消息 摘要 算法 第 5 版 
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( 续 表 ) 
术语 简称 术语 全 称 说 明 
MP3 Moving Picture Experts Group Audio Layer II | 动态 图 像 专家 组 的 音频 层面 3， 一 种 音频 格式 
MP4 Moving Picture Experts Group 4 动态 图 像 专家 组 4， 一 种 视频 格式 
MPEG Moving Picture Experts Group 动态 图 像 专家 组 ， 一 种 视频 编码 技术 
NDK Native Development Kit 原生 开发 工具 包 
NFC Near Field Communication 近 场 通信 
OpenCV Open Source Computer Vision Library 开源 计算 机 视觉 库 
OpenGL Open Graphics Library 开放 图 形 库 
OpenGL ES | OpenGL for Embedded Systems 嵌入 式 系 统 上 的 OpenGL 
PDF Portable Document Format 便携 式 文档 格式 
PIP Picture In Picture 画 中 画 
PNG Portable Network Graphics 便携 式 网 络 图 形 
POI Point Of Interest 兴趣 点 (信息 点 ) 
QR Code Quick Response Code 二 维 码 
RFID Radio Frequency Identification 射频 识别 技术 
RAM Random Access Memory 随机 存储 器 ， 即 手机 的 运行 内 存 
ROM Read-Only Memory 只 读 存储 器 ， 即 手机 的 机 身 内 存 
SDK Software Development Kit 软件 开发 工具 包 
SD 卡 Secure Digital Memory Card 安全 数码 存储 卡 
SHAI1 Secure Hash Algorithm 1 安全 哈 希 算法 1 
SM3 CHA SM3 Cryptographic Hash Algorithm na 
的 拼音 首 字母 ) 
SVG Scalable Vector Graphics 可 缩放 矢量 图 形 
TS Text To Speech 从 文本 到 语音 
UE User Experience 用 户 体验 
UI User Interface 用 户 界面 
URL Uniform Resource Locator 统一 资源 定位 符 
USB Universal Serial Bus 通用 串 行 总 线 
VR Virtual Reality 虚拟 现实 
WiFi Wireless Fidelity 基于 IEEE 802.11b 标准 的 无 线 局 域 网 
WLAN Wireless Local Area Networks 无 线 局 域 网 络 
XML eXtensible Markup Language 可 扩展 标记 语言 








